Metodo ITLegacyCallMediaControl2::GenerateCustomTonesByCollection (tapi3if.h)

Articolo
03/05/2024

Il metodo GenerateCustomTonesByCollection genera il tono personalizzato specificato.

Questo metodo è destinato alle applicazioni visual Basic e di scripting. Le applicazioni C/C++ devono usare invece il metodo GenerateCustomTones .

Sintassi

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

Parametri

[in] pCustomToneCollection

Puntatore a un'interfaccia ITCollection2 contenente una raccolta di puntatori di interfaccia ITCustomTone che rappresentano i componenti del tono. Se la raccolta è un tono multifrequenza, i vari toni vengono riprodotti contemporaneamente.

[in] lDuration

Durata, in millisecondi, durante la quale deve essere sostenuto il tono. Il valore zero usa una durata predefinita.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pCustomToneCollection non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per allocare il buffer dei toni.
TAPI_E_INVALCALLSTATE	La chiamata deve trovarsi nello stato connesso .

Commenti

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.

Requisiti

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

Vedi anche

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2

Condividi tramite