ITLegacyCallMediaControl2::GenerateCustomTones method (tapi3if.h)

Article
02/22/2024

The GenerateCustomTones method generates the specified custom tone.

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

Syntax

HRESULT GenerateCustomTones(
  [in] TAPI_CUSTOMTONE *pToneList,
  [in] long            lNumTones,
  [in] long            lDuration
);

Parameters

[in] pToneList

Pointer to a TAPI_CUSTOMTONE array that specifies the tones to generate.

[in] lNumTones

The number of entries in the array specified by the pToneList parameter.

[in] lDuration

The duration, in milliseconds, during which the tone should be sustained.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method translates to a call to the TAPI 2.x lineGenerateTone function.

Requirements

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