ITLegacyCallMediaControl2::GenerateCustomTonesByCollection-Methode (tapi3if.h)

Artikel
03/06/2024

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
S_OK	Methode war erfolgreich.
E_POINTER	Der pCustomToneCollection-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Puffer für Töne zuzuordnen.
TAPI_E_INVALCALLSTATE	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

Weitere Informationen

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2

Freigeben über