ITTerminalManager::CreateDynamicTerminal-Methode (termmgr.h)

Artikel
07/16/2024

Die CreateDynamicTerminal Methode erstellt ein dynamisches Terminal einer angegebenen Terminalklasse, Medientyp und Richtung.

Syntax

HRESULT CreateDynamicTerminal(
  [in]  IUnknown           *pOuterUnknown,
  [in]  IID                iidTerminalClass,
  [in]  DWORD              dwMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [in]  MSP_HANDLE         htAddress,
  [out] ITTerminal         **ppTerminal
);

Parameter

[in] pOuterUnknown

Wenn MSP das Terminalobjekt aggregiert, wird für das MSP-Objekt der IUnknown-Schnittstellenzeiger festgelegt. In der Regel ist dies auf NULL-festgelegt.

[in] iidTerminalClass

GUID, die die zu erstellende Terminalklasse identifiziert.

[in] dwMediaType

Deskriptor Medientyps für Stream.

[in] Direction

TERMINAL_DIRECTION Deskriptor der Mediendatenstromrichtung für Terminal.

[in] htAddress

MSP-Handle.

[out] ppTerminal

Zeiger auf ITTerminal Schnittstelle für neues Terminal.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Der fMessageWaiting Parameter ist ungültig.
E_POINTER	Der ppAddress Parameter ist kein gültiger Zeiger.

Bemerkungen

Bei der Auswahl eines Werts für pTerminalClasssind die einzigen GuiDs der Terminalklasse, die verwendet werden können, diejenigen, die "dynamisch" erstellt werden. Beispielsweise können in allen derzeit von TAPI3 definierten Terminalklassen nur folgende Elemente mit CreateTerminal verwendet werden: CLSID_MediaStreamTerminal und CLSID_VideoWindowTerm.

Darüber hinaus können nur die dynamischen Terminalklassen verwendet werden, die für diese Adresse unterstützt werden. Die Anwendung kann diese Werte mithilfe von ITTerminalSupport::EnumerateDynamicTerminalClasses oder ITTerminalSupport::get_DynamicTerminalClassesermitteln.

Die Anwendung muss die pTerminalClassBSTR- in zwei Schritten abrufen: Rufen Sie StringFromIID- auf, um die GUID in eine LPOLESTR-zu konvertieren, und rufen Sie dann SysAllocString auf, um die LPOLESTR- in einen BSTR-zu konvertieren.

Die Anwendung muss SysFreeString- verwenden, um den für den pTerminalClass Parameter zugeordneten Speicher freizugeben.