Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 359
resume paused play — dx_resume( )
dx_resume( )
resume paused play
!
!!
! Description
The dx_resume( ) function resumes the play that was paused using dx_pause( ). The play is
resumed exactly where the play was paused (that is, no data is lost). The application will not get an
event when dx_resume( ) is issued. This function does not return an error if the channel is already
in the requested state.
You can also pause and resume play using a DTMF digit. For more information, see SV_PAUSE
and SV_RESUME in the DX_SVCB data structure and dx_setsvcond( ).
For more information on the pause and resume play feature, see the Voice API Programming
Guide.
!
!!
! Cautions
None.
!
!!
! Errors
If the function returns -1, use the Standard Runtime Library ATDV_LASTERR( ) standard
attribute function to return the error code or ATDV_ERRMSGP( ) to return the descriptive error
message. Possible errors for this function include:
EDX_BUSY
Invalid state. Returned when the function is issued but play has not been paused on the
channel.
Name: int dx_resume(chdev)
Inputs: int chdev
• valid channel device handle
Returns: 0 if success
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: I/O
Mode: synchronous
Platform: DM3
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )