ITLegacyCallMediaControl2::CreateDetectToneObject method (tapi3if.h)

The CreateDetectToneObject method creates a detect tone object to use with the DetectTonesByCollection method.

This method is intended for Visual Basic and scripting applications. C/C++ applications should use the DetectTones method instead.

Syntax

HRESULT CreateDetectToneObject(
  [out] ITDetectTone **ppDetectTone
);

Parameters

[out] ppDetectTone

Pointer to an ITDetectTone interface.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The ppDetectTone parameter is not a valid pointer.
E_OUTOFMEMORY	There is not enough memory to allocate the object.

Remarks

TAPI calls the AddRef method on the ITDetectTone interface returned by ITLegacyCallMediaControl2::CreateDetectToneObject. The application must call the Release method on the ITDetectTone interface to free resources associated with it.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h
Library	Uuid.lib
DLL	Tapi3.dll

See also

DetectTonesByCollection

ITDetectTone

ITLegacyCallMediaControl2