Metodo ITLegacyCallMediaControl2::GenerateCustomTonesByCollection (tapi3if.h)
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 |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pCustomToneCollection non è un puntatore valido. |
|
Memoria insufficiente per allocare il buffer dei toni. |
|
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 |