次の方法で共有

ITTerminalSupport::GetDefaultStaticTerminal メソッド (tapi3if.h)

  • [アーティクル]

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
 ターミナル オブジェクトを作成するためのメモリが不足しています。

解説

このメソッドは動的ターミナルを返しません。 たとえば、TAPIMEDIATYPE_VIDEOのメディア タイプと、TD_RENDERの端末方向を持つ場合、動的ターミナルが定義されます。このメソッドは、これらのパラメーターで失敗します。

このメソッドによって返される既定の静的ターミナルは、 ITTerminalSupport::EnumerateStaticTerminals または ITTerminalSupport::get_StaticTerminals によって返される静的ターミナルの 1 つです。 通常、既定のターミナルは、コントロール パネルの [サウンドとマルチメディアのプロパティ] アプレットで [優先デバイス] として選択されます。

TAPI は、ITTerminalSupport::GetDefaultStaticTerminal によって返される ITTerminal インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITTerminal インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。

要件

   
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)

関連項目

Address オブジェクト

ITTerminalSupport

メディアの種類

TERMINAL_DIRECTION

ターミナル オブジェクト

ターミナル オブジェクト インターフェイス