ITTerminalSupport：：GetDefaultStaticTerminal 方法 (tapi3if.h)

發行項
08/26/2023

GetDefaultStaticTerminal方法會取得指定之媒體類型的預設靜態終端機。

語法

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

參數

[in] lMediaType

所需終端機的媒體類型。

[in] Direction

TERMINAL_DIRECTION 終端方向的描述項。

[out] ppTerminal

ITTerminal 介面的指標。如果沒有可用的終端機，則為 Null。

傳回值

這個方法可以傳回其中一個值。

值	意義
S_OK	方法成功。
S_FALSE	沒有可用的終端機。 *ppTerminal 會傳回為 Null。
E_FAIL	未指定的錯誤。
E_POINTER	lMediaType參數不是有效的指標。
E_MEDIATYPE	lMediaType參數不是有效的媒體類型。
E_OUTOFMEMORY	記憶體不足，無法建立 Terminal 物件。

備註

這個方法不會傳回動態終端機。例如，具有TAPIMEDIATYPE_VIDEO的媒體類型，以及TD_RENDER的終端機方向會定義動態終端機;這個方法將會失敗，並包含這些參數。

此方法傳回的預設靜態終端機是 ITTerminalSupport：：EnumerateStaticTerminals 或 ITTerminalSupport：：get_StaticTerminals所傳回的其中一個靜態終端機。通常，預設終端機是在主控台的「音效和多媒體屬性」小程式中選取為「慣用裝置」的終端機。

TAPI 會在ITTerminalSupport：：GetDefaultStaticTerminal傳回的 ITTerminal介面上呼叫AddRef方法。應用程式必須在ITTerminal介面上呼叫Release，以釋放與其相關聯的資源。