LINEGENERATETONE (structure)
A version of this page is also available for
4/8/2010
This structure contains information about a tone to be generated. This structure is used by the lineGenerateTone (function) and TSPI_lineGenerateTone functions.
Syntax
typedef struct linegeneratetone_tag {
DWORD dwFrequency;
DWORD dwCadenceOn;
DWORD dwCadenceOff;
DWORD dwVolume;
} LINEGENERATETONE, FAR* LPLINEGENERATETONE;
Members
- dwFrequency
Frequency of this tone component, in hertz. A service provider may adjust (round up or down) the frequency specified by the application to fit its resolution.
- dwCadenceOn
Length of the "on" duration of the cadence of the custom tone to be generated, in milliseconds. Zero means no tone is generated.
- dwCadenceOff
Length of the "off" duration of the cadence of the custom tone to be generated, in milliseconds. Zero means no off time, that is, a constant tone.
- dwVolume
Volume level at which the tone is to be generated. A value of 0x0000FFFF specifies full volume, and a value of 0x00000000 specifies silence.
Remarks
This structure may not be extended.
This structure is used only for the generation of tones. It is not used for tone monitoring.
Requirements
| Header | tapi.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |