ITTerminalSupport::GetDefaultStaticTerminal-Methode (tapi3if.h)

Artikel
08/26/2023

Die GetDefaultStaticTerminal-Methode ruft das statische Standardterminal für den angegebenen Medientyp ab.

Syntax

HRESULT GetDefaultStaticTerminal(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

Parameter

[in] lMediaType

Medientyp des erforderlichen Terminals.

[in] Direction

TERMINAL_DIRECTION Deskriptor der Endrichtung.

[out] ppTerminal

Zeiger auf die ITTerminal-Schnittstelle . NULL , wenn kein Terminal verfügbar ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
S_FALSE	Es ist kein Terminal verfügbar. *ppTerminal wird als NULL zurückgegeben.
E_FAIL	Unbekannter Fehler.
E_POINTER	Der lMediaType-Parameter ist kein gültiger Zeiger.
E_MEDIATYPE	Der lMediaType-Parameter ist kein gültiger Medientyp.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Terminal-Objekt zu erstellen.

Hinweise

Diese Methode gibt keine dynamischen Terminals zurück. Mit einem Medientyp von TAPIMEDIATYPE_VIDEO und einer Endrichtung von TD_RENDER wird beispielsweise ein dynamisches Terminal definiert. Diese Methode schlägt mit diesen Parametern fehl.

Das statische Standardterminal, das von dieser Methode zurückgegeben wird, ist eines der statischen Terminals, die von ITTerminalSupport::EnumerateStaticTerminals oder ITTerminalSupport::get_StaticTerminals zurückgegeben werden. In der Regel ist das Standardterminal im Applet "Sounds and Multimedia Properties" von Systemsteuerung als "bevorzugtes Gerät" ausgewählt.

TAPI ruft die AddRef-Methode auf der ITTerminal-Schnittstelle auf, die von ITTerminalSupport::GetDefaultStaticTerminal zurückgegeben wird. Die Anwendung muss Release auf der ITTerminal-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.