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。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
ターミナルは使用できません。 *ppTerminal は NULL として返されます。 |
|
未定義のエラーが発生しました。 |
|
lMediaType パラメーターが有効なポインターではありません。 |
|
lMediaType パラメーターが有効なメディアの種類ではありません。 |
|
ターミナル オブジェクトを作成するためのメモリが不足しています。 |
解説
このメソッドは動的ターミナルを返しません。 たとえば、TAPIMEDIATYPE_VIDEOのメディア タイプと、TD_RENDERの端末方向を持つ場合、動的ターミナルが定義されます。このメソッドは、これらのパラメーターで失敗します。
このメソッドによって返される既定の静的ターミナルは、 ITTerminalSupport::EnumerateStaticTerminals または ITTerminalSupport::get_StaticTerminals によって返される静的ターミナルの 1 つです。 通常、既定のターミナルは、コントロール パネルの [サウンドとマルチメディアのプロパティ] アプレットで [優先デバイス] として選択されます。
TAPI は、ITTerminalSupport::GetDefaultStaticTerminal によって返される ITTerminal インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITTerminal インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |