Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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_lineGenerateTonefunctions.

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

See Also