Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 417
force termination of currently active I/O functions — dx_stopch( )
dx_stopch( )
force termination of currently active I/O functions
!
!!
! Description
The dx_stopch( ) function forces termination of currently active I/O functions on a channel. It
forces a channel in the busy state to become idle. If the channel specified in chdev already is idle,
dx_stopch( ) has no effect and will return a success.
Running this function asynchronously will initiate the dx_stopch( ) without affecting processes on
other channels.
Running this function synchronously within a process does not block other processing. Other
processes continue to be serviced.
When you issue dx_stopch( ) to terminate an I/O function, the termination reason returned by
ATDX_TERMMSK( ) is TM_USRSTOP. However, if dx_stopch( ) terminates a dx_dial( )
function with call progress analysis, use ATDX_CPTERM( ) to determine the reason for call
progress analysis termination, which is CR_STOPD.
Name: int dx_stopch(chdev, mode)
Inputs: int chdev
• valid channel device handle
unsigned short mode
• mode flag
Returns: 0 if success
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: I/O
Mode: asynchronous or synchronous
Platform: DM3, Springware