Intel 05-1832-002 IP Phone User Manual


 
300 Voice API for Windows Operating Systems Library Reference — November 2003
dx_play( ) — play recorded voice data
tptp Points to the Termination Parameter Table structure, DV_TPT, which
specifies termination conditions for playing. For more information on this
structure, see DV_TPT, on page 485.
Note: In addition to DV_TPT terminations, the function can fail due to
maximum byte count, dx_stopch( ), or end of file. See
ATDX_TERMMSK( ) for a full list of termination reasons.
mode Defines the play mode and asynchronous/synchronous mode. One or more of
the play mode parameters listed below may be selected in the bit mask for
play mode combinations (see Table 10).
Choose one only:
EV_ASYNC – run asynchronously
EV_SYNC – run synchronously (default)
On DM3 boards, choose one or more of the following:
MD_ADPCM – play using Adaptive Differential Pulse Code Modulation
encoding algorithm (4 bits per sample). Playing with ADPCM is the
default setting.
MD_PCM – play using Pulse Code Modulation encoding algorithm
PM_ALAW – play using A-law
PM_SR6 – play using 6 kHz sampling rate (6000 samples per second)
PM_SR8 – play using 8 kHz sampling rate (8000 samples per second)
PM_TONE – transmit a tone before initiating play. If this mode is not
selected, no tone will be transmitted. No tone transmitted is the default
setting.
On Springware boards, choose one or more of the following:
MD_ADPCM – play using Adaptive Differential Pulse Code Modulation
encoding algorithm (4 bits per sample). Playing with ADPCM is the
default setting.
MD_PCM – play using Pulse Code Modulation encoding algorithm (8 bits
per sample)
PM_ALAW – play using A-law
PM_ADSI – play using the ADSI protocol without an alert tone preceding
play. If ADSI protocol mode is selected, it is not necessary to select any
other play mode parameters. If ADSI data will be transferred, PM_ADSI
should be ORed with the EV_SYNC or EV_ASYNC parameter in the
mode parameter.
PM_ADSIALERT – play using the ADSI protocol with an alert tone
preceding play. If ADSI protocol mode is selected, it is not necessary to
select any other play mode parameters. PM_ADSIALERT should be
ORed with the EV_SYNC or EV_ASYNC parameter in the mode
parameter.
PM_SR6 – play using 6 kHz sampling rate (6000 samples per second)
PM_SR8 – play using 8 kHz sampling rate (8000 samples per second)
PM_TONE – transmit a tone before initiating play. If this mode is not
selected, no tone will be transmitted. No tone transmitted is the default
setting.
Parameter Description