Intel 05-1832-002 User Manual
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
. 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.
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
and SV_RESUME in the
data structure and
.
For more information on the pause and resume play feature, see the Voice API Programming
Guide.
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:
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.
channel.
Name:
int dx_resume(chdev)
Inputs:
int chdev
•
valid channel device handle
Returns:
0 if success
-1 if failure
-1 if failure
Includes:
srllib.h
dxxxlib.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( )
using dx_open( )