Metodo ITLegacyCallMediaControl2::GenerateTone (tapi3if.h)

Il metodo GenerateTone genera il tono specificato.

Per generare toni personalizzati, chiamare il metodo GenerateCustomTones (C/C++) o il metodo GenerateCustomTonesByCollection (applicazioni Visual Basic e scripting).

Sintassi

HRESULT GenerateTone(
  [in] TAPI_TONEMODE ToneMode,
  [in] long          lDuration
);

[in] ToneMode

Indica la modalità tono. I valori usati sono quelli dell'enumerazione TAPI_TONEMODE .

[in] lDuration

Sia la durata, in millisecondi, delle cifre DTMF e dell'intervallo DTMF.

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Uno dei parametri non è valido.
TAPI_E_INVALCALLSTATE	La chiamata deve trovarsi nello stato connesso .

Questo metodo si traduce in una chiamata al TAPI 2. Funzione xlineGenerateTone .

Al termine della generazione del tono, viene generato un evento di tipo TE_GENERATEEVENT.

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tapi3if.h
Libreria	Uuid.lib
DLL	Tapi3.dll