Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 311
play back recorded voice data from multiple sources — dx_playiottdata( )
!
!!
! Cautions
• All files specified in the DX_IOTT table must be of the same file format type and match the
file format indicated in DX_XPB.
• All files specified in the DX_IOTT table must contain data of the type described in DX_XPB.
• When playing or recording VOX files, the data format is specified in DX_XPB rather than
through the mode argument of this function.
• The DX_IOTT data area must remain in scope for the duration of the function if running
asynchronously.
• The DX_XPB data area must remain in scope for the duration of the function if running
asynchronously.
• When set to play WAVE files, all other fields in the DX_XPB are ignored.
• When set to play WAVE files, this function will fail if an unsupported data format is attempted
to be played. For information about supported data formats, see the description for DX_XPB,
on page 520 and the Voice API Programming Guide.
!
!!
! Errors
In asynchronous mode, the function returns immediately and a TDX_PLAY event is queued upon
completion. Check ATDX_TERMMSK( ) for the termination reason. If a failure occurs during
playback, then a TDX_ERROR event will be queued. Use ATDV_LASTERR( ) to determine the
reason for the error. In some limited cases such as when invalid arguments are passed to the library,
Parameter Description
chdev Specifies the valid channel device handle obtained when the channel was
opened using dx_open( ).
iottp Points to the I/O Transfer Table structure, DX_IOTT, which specifies the order
of playback and the location of voice data. See DX_IOTT, on page 509, for
information about the data structure.
The order of playback and the location of the voice data is specified in an array
of DX_IOTT structures pointed to by iottp.
tptp Points to the Termination Parameter Table structure, DV_TPT, which specifies
termination conditions for this function. For more information on termination
conditions, see DV_TPT, on page 485.
xpbp Points to the I/O Transfer Parameter Block, DX_XPB.The file format for the
files to be played is specified in the wFileFormat field of the DX_XPB. Other
fields in the DX_XPB describe the data format.
For more information about this structure, see the description for DX_XPB, on
page 520. For information about supported data formats, see the Voice API
Programming Guide.
mode Specifies the play mode and synchronous/asynchronous mode. For a list of all
valid values, see the dx_play( ) function description.
• PM_TONE – play 200 msec audible tone
• EV_SYNC – synchronous mode
• EV_ASYNC – asynchronous mode