2.2.6.27 LINEGENERATETONE

The LINEGENERATETONE packet contains information about a tone to be generated. This packet is used by the GenerateTone packet.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwFrequency

dwCadenceOn

dwCadenceOff

dwVolume

dwFrequency (4 bytes): An unsigned 32-bit integer. The frequency, in hertz, of this tone component. A service provider can adjust (round up or down) the frequency specified by the application to fit its resolution.

dwCadenceOn (4 bytes): An unsigned 32-bit integer. The length, in milliseconds, of the "on" duration of the cadence of the custom tone to be generated. Zero means no tone is generated.

dwCadenceOff (4 bytes): An unsigned 32-bit integer. The length, in milliseconds, of the "off" duration of the cadence of the custom tone to be generated. Zero means no off time, that is, a constant tone.

dwVolume (4 bytes): An unsigned 32-bit integer. 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.

This packet cannot be extended. This packet is used only for the generation of tones. It MUST NOT be used for tone monitoring.