ITStreamControl::CreateStream-Methode (tapi3if.h)

Artikel
08/26/2023

Die CreateStream-Methode erstellt einen neuen Mediendatenstrom.

Syntax

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

Parameter

[in] lMediaType

Gibt den Medientyp für den Stream an.

[in] td

Gibt die TERMINAL_DIRECTION an.

[out] ppStream

Zeiger auf den Zeiger für die neu erstellte ITStream-Schnittstelle .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_POINTER	Der ppStream-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
TAPI_E_INVALIDMEDIATYPE	Der lMediaType-Parameter ist kein gültiger Medientyp.
TAPI_E_INVALIDDIRECTION	Der td-Parameter ist keine gültige Endrichtung.
TAPI_E_MAXSTREAMS	Die maximale Anzahl der unterstützten Streams wurde bereits erreicht.
TAPI_E_NOTSUPPORTED	Diese Operation wird nicht unterstützt.

Hinweise

Viele MSPs unterstützen die dynamische Erstellung von Streams nicht und geben einfach TAPI_E_MAXSTREAMS in ihrer Implementierung dieser Methode zurück. Standarddatenströme sind automatisch verfügbar, wenn ein Aufruf erstellt wird, sodass die meisten Anwendungen diese Methode nicht verwenden müssen.

Das Erstellen oder Entfernen von Daten kann eine Interaktion mit einem Remoteendpunkt beinhalten, was zu einer CMC_REMOTE_REQUEST anstelle der CMC_LOCAL_REQUEST Nachrichten führt, die empfangen werden, wenn ein Stream beendet oder gestartet wird.

TAPI ruft die AddRef-Methode für die ITStream-Schnittstelle auf, die von ITStreamControl::CreateStream zurückgegeben wird. Die Anwendung muss Release auf der ITStream-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.