LINEGENERATETONE

  • Article

This structure contains information about a tone to be generated. This structure is used by the lineGenerateTone and TSPI_lineGenerateTone functions.

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

OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.

See Also

lineGenerateTone | TSPI_lineGenerateTone

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.