ITLegacyCallMediaControl2::GenerateCustomTonesByCollection-Methode (tapi3if.h)
Die GenerateCustomTonesByCollection-Methode generiert den angegebenen benutzerdefinierten Ton.
Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. C/C++-Anwendungen sollten stattdessen die GenerateCustomTones-Methode verwenden.
Syntax
HRESULT GenerateCustomTonesByCollection(
[in] ITCollection2 *pCustomToneCollection,
[in] long lDuration
);
Parameter
[in] pCustomToneCollection
Zeiger auf eine ITCollection2-Schnittstelle , die eine Auflistung von ITCustomTone-Schnittstellenzeigern enthält, die die Komponenten des Tones darstellen. Wenn es sich bei der Sammlung um einen mehrstufigen Ton handelt, werden die verschiedenen Töne gleichzeitig wiedergegeben.
[in] lDuration
Die Dauer in Millisekunden, während derer der Ton anhalten soll. Der Wert 0 (null) verwendet eine Standarddauer.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pCustomToneCollection-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Puffer für Töne zuzuordnen. |
|
Der Aufruf muss sich im Zustand verbunden befinden. |
Hinweise
Diese Methode wird in einen Aufruf von TAPI 2 übersetzt. xlineGenerateTone-Funktion .
Wenn die Tongenerierung abgeschlossen ist, wird ein Ereignis vom Typ TE_GENERATEEVENT generiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |