The VoipMediaEngine..::.DTMF_EVENT_DATA type exposes the following members.

Fields

  NameDescription
AverageNoiseMagDb
This is the power of the average noise signal at the time of detection. It is specified in dB (Decibels). The 0dB power level is referenced to full scale sin(x) 16 bit PCM. Only applies to in-band DTMF detected digits.
DtmfTone
Represents the DTMF tone that was detected. For supported DTMF tones, see the VoipMediaEngine..::.DTMF_TONE enumeration.
Freq1MagDb
This is the power of the lower DTMF frequency signal at the time of detection. It is specified in dB (Decibels). The 0dB power level is referenced to full scale sin(x) 16 bit PCM. Only applies to in-band DTMF detected digits.
Freq2MagDb
This is the power of the higher DTMF frequency signal at the time of detection. It is specified in dB (Decibels). The 0dB power level is referenced to full scale sin(x) 16 bit PCM. Only applies to in-band DTMF detected digits.
MuteLocalDtmfTonePlayback
This value can be set to a non zero value to allow the media engine to temporarily disable local DTMF tone playback for the tone.
Caution:
IMPORTANT:

If you set this member to a non zero value to disable DTMF tone playback for the DTMF ON event indication, you must also set this member to a non zero value to disable DTMF tone playback for the DTMF OFF event indication. The reason behind this is that internal DTMF playback tone generation ON/OFF transitions are reference counted. In order for local DTMF tone playback to be managed properly, the muting of ON and OFF transitions must be the same. If you follow this rule, local DTMF tone generation playback will function as expected.

PhoneLine
The zero based phone line that detected the DTMF event.
StateOn
Indicates whether the DTMF digit has transitioned to the "ON" state or the "OFF" state.

See Also