libvpb 4.2.52
|
![]() |
Classes | |
struct | VPB_TONE |
Tone definition structure. More... | |
Enumerations | |
enum | VPB_TONE_ID { VPB_TONE_DIAL, VPB_TONE_RINGING, VPB_TONE_BUSY, VPB_TONE_CONGESTION, VPB_TONE_UNOBTAINABLE, VPB_TONE_CALLWAITING, VPB_TONE_STUTTERDIAL, VPB_TONE_ID_MAX } |
Symbolic identifiers for predefined, localised tones. More... | |
Functions | |
int WINAPI | vpb_playtone_state (int handle) |
Returns state of play tone (1= playing, 0 = not playing) | |
Tone generation | |
int WINAPI | vpb_playtone_async (int handle, const VPB_TONE &vpb_tone) |
Start a user defined tone playing and return immediately. | |
int WINAPI | vpb_playtone_async (int handle, const VPB_TONE *vpb_tone) |
Start a user defined tone playing and return immediately. | |
int WINAPI | vpb_playtone_async (int handle, VPB_TONE_ID tone_id) |
Start a locale specific predefined tone playing and return immediately. | |
int WINAPI | vpb_playtone_sync (int handle, const VPB_TONE &vpb_tone) |
Play a user defined tone, return when playback completes. | |
int WINAPI | vpb_playtone_sync (int handle, const VPB_TONE *vpb_tone) |
Play a user defined tone, return when playback completes. | |
int WINAPI | vpb_playtone_sync (int handle, VPB_TONE_ID tone_id) |
Play a locale specific predefined tone, return when playback completes. | |
int WINAPI | vpb_tone_terminate (int handle) |
Terminate a currently playing tone (user defined or dtmf). | |
Dial string aliases | |
int WINAPI | vpb_settone (char ident, const VPB_TONE *tone) |
Enables user to (re)define the tone associated with a dial string character. | |
int WINAPI | vpb_gettone (char ident, VPB_TONE *tone) |
Get the parameters of the tone represented in dial strings by ident. |
enum VPB_TONE_ID |
Symbolic identifiers for predefined, localised tones.
int WINAPI vpb_gettone | ( | char | ident, |
VPB_TONE * | tone | ||
) |
Get the parameters of the tone represented in dial strings by ident.
ident | The dial string character to retrieve tone data for. |
tone | The returned VPB_TONE parameters for ident. |
VPB_OK
if all went well. various | exceptions may be thrown in the event of error. |
int WINAPI vpb_playtone_state | ( | int | handle | ) |
Returns state of play tone (1= playing, 0 = not playing)
References IDLE, VPBREG::toneg, vpb_c, and Comm::vpbreg().
int WINAPI vpb_settone | ( | char | ident, |
const VPB_TONE * | tone | ||
) |
Enables user to (re)define the tone associated with a dial string character.
ident | The dial string character to use for this tone. |
tone | The VPB_TONE structure that defines this tone. |
Any occurrence of ident in a dial string sent via vpb_dial_sync()
or similar functions will subsequently use the tone defined here.
VPB_OK
if all went well. various | exceptions may be thrown in the event of error. |
vpb_open()
if you wish to redefine the default tones, else your settings for those will be overwritten. References VPB_TONE::freq1, VPB_TONE::freq2, VPB_TONE::freq3, VPB_TONE::level1, VPB_TONE::level2, and VPB_TONE::level3.
int WINAPI vpb_tone_terminate | ( | int | handle | ) |
Terminate a currently playing tone (user defined or dtmf).
handle | The handle of the port to stop tone playback for. |
VPB_OK
if all went well. various | exceptions may be thrown if things go badly. |
References Stop(), VPBREG::toneg, vpb_c, and Comm::vpbreg().
Referenced by vpb_reset().