LINEGENERATETONE

The LINEGENERATETONE structure contains information about a tone to be generated.

typedef struct linegeneratetone_tag {
    DWORD  dwFrequency;
    DWORD  dwCadenceOn;
    DWORD  dwCadenceOff;
    DWORD  dwVolume;
} LINEGENERATETONE, FAR *LPLINEGENERATETONE; 
 

Members

dwFrequency

The frequency in hertz of this tone component. A service provider may adjust (round up or down) the frequency specified by the application to fit its resolution.

dwCadenceOn

The "on" duration in milliseconds of the cadence of the custom tone to be generated. Zero means no tone is generated.

dwCadenceOff

The "off" duration in milliseconds of the cadence of the custom tone to be generated. Zero means no off time, that is, a constant tone.

dwVolume

The volume level at which the tone is to be generated. A value of 0x0000FFFF represents full volume, and a value of 0x00000000 is silence.

Remarks

No extensions.

This structure is only used for the generation of tones. It is not used for tone monitoring.