ITLegacyCallMediaControl2::GenerateCustomTonesByCollection method (tapi3if.h)
The GenerateCustomTonesByCollection method generates the specified custom tone.
This method is intended for Visual Basic and scripting applications. C/C++ applications should use the GenerateCustomTones method instead.
HRESULT GenerateCustomTonesByCollection( ITCollection2 *pCustomToneCollection, long lDuration );
Pointer to an ITCollection2 interface containing a collection of ITCustomTone interface pointers representing the tone's components. If the collection is a multifrequency tone, the various tones are played simultaneously.
The duration, in milliseconds, during which the tone should be sustained. A value of zero uses a default duration.
This method can return one of these values.
||The pCustomToneCollection parameter is not a valid pointer.|
||There is not enough memory to allocate the tones buffer.|
||The call must be in the connected state.|
This method translates to a call to the TAPI 2.x lineGenerateTone function.
When tone generation finishes, an event of type TE_GENERATEEVENT is generated.