Partager via

LINEGENERATETONE (structure) (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

TAPI Structures
lineGenerateTone (function)
TSPI_lineGenerateTone