The VoipMediaEngine class is the primary class for accessing all the capabilities of the LanScape VOIP Media Engine.

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

Constructors

  NameDescription
VoipMediaEngine..::.DtmfGenerator
Initializes a new instance of the VoipMediaEngine..::.DtmfGenerator class

Methods

  NameDescription
CreateDtmfGenerator
The CreateDtmfGenerator API procedure is used to create a DTMF generator. Once application software creates a DTMF generator, the DTMF generator can be turned on to generate audio sample blocks containing encoded DTMF tone data. It can also be turned off to terminate the generation of DTMF tone data.

Each sample block generated will contain 20Ms worth of PCM data using a sampling rate of 8kHz (this is equivalent to 160 - 16 bit PCM samples per block). Applications usually pass the DTMF generated sample blocks to the Media Engine's "transmit IVR Phone Line interface".

Before your application terminates, you must call the DestroyDtmfGenerator()()() API procedure to destroy the DTMF generator and to regain its resources.

DestroyDtmfGenerator
The DestroyDtmfGenerator API procedure is used to destroy a previously created DTMF generator and reclaim all resources associated with the generator.
Finalize
The Object's finalizer.
(Overrides Object..::.Finalize()()().)
SetDtmfGeneratorAmplitude
The SetDtmfGeneratorAmplitude API procedure is used to set the amplitude (volume) of generated DTMF data blocks. For most cases, application software can allow the DTMF generator to use its default amplitude.
StartDtmfGeneratorTone
The StartDtmfGeneratorTone API procedure is used to start the generation of DTMF sample blocks for a specific DTMF tone. The DTMF generator will call the user supplied call back procedure (that was specified by the CallbackProc parameter of the CreateDtmfGenerator(VoipMediaEngine, VoipMediaEngine..::.DTMF_GENERATOR_CALLBACK_PROC, Object) API procedure) when DTMF generator sample blocks are ready.

Once the application receives DTMF generated sample blocks, it can process them as required by the application.

To stop the generation of DTMF sample blocks at any time, call the StopDtmfGeneratorTone()()() API procedure.

StopDtmfGeneratorTone
The StopDtmfGeneratorTone API procedure is used to stop DTMF tone generation.
WaitForDtmfGeneratorToneCompletion
The WaitForDtmfGeneratorToneCompletion API procedure can be used to wait until a DTMF generator fully completes generating all DTMF tone data for a specified duration. For additional information, see the remarks section below.

Fields

  NameDescription
hDtmfGeneratorHandle
The actual media enigne DTMF generator native handle. Do not modify this value directly.
MediaEngine
The media enigne instance. Do not modify this value directly.
pManagedDtmfGeneratorInstance
A pseudo pointer to this managed wrapper. Do not modify this value directly.
pUserDtmfGeneratorProc_Mananged
An internal callback handler. Do not modify this value directly.
UserDefinedData_Mananged
Instance data passed to an internal callback handler. Do not modify this value directly.

See Also