ITStream::SelectTerminal メソッド (tapi3if.h)

SelectTerminal メソッドは、ストリーム上の ITTerminal オブジェクトを選択します。

構文

HRESULT SelectTerminal(
  [in] ITTerminal *pTerminal
);

パラメーター

[in] pTerminal

選択したターミナルの IT ターミナル インターフェイスへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

意味
S_OK
メソッドが成功しました。
E_POINTER
pTerminal パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
操作を実行するためのメモリが不足しています。
TAPI_E_MAXTERMINALS
ストリーム上で複数の端末が選択されていますが、メディアの混合または分割はできません。
TAPI_E_INVALIDTERMINAL
選択したターミナルが無効です。

注釈

トランスポートがメディアのストリーミングを可能にする状態であるかどうかに関係なく、いつでもターミナルを選択できます。 トランスポートがメディアのストリーミングを許可する状態で、アプリケーションがストリームで ITStream::P auseStream または ITStream::StopStream を正常に呼び出していない場合、またはこのストリームに対して ITStream::P auseStream または ITStream::StopStream を正常に呼び出したよりも最近このストリームに対して ITStream::StartStream を正常に呼び出した場合は、ターミナルが選択されるとすぐにストリーミングが自動的に開始されます。 トランスポートがメディアをストリーミングできる状態になる前にストリームでターミナルが選択され、 StopStream または PauseStream への後続の呼び出しが行われなかった場合、トランスポートがメディアをストリーミングできる状態になると、ストリームが自動的に開始されます。

CME_STREAM_ACTIVE イベントは、ストリーミングが実際に開始されるときに生成されます。これは 、SelectTerminal 呼び出しよりも後になる可能性があります。 ストリーミングが実際に失敗すると、CME_STREAM_FAILまたはCME_TERMINAL_FAIL イベントが生成されます。これは 、SelectTerminal 呼び出しよりも後になる場合もあります。

ITTerminal::get_MediaType の結果が ITStream::get_MediaType と一致する場合にのみ、ターミナルをストリーム選択できます。 さらに、一部の MSP では 、ITTerminal::get_DirectionITStream::get_Direction の間で一致が必要になる場合がありますが、インターフェイスではこれを強制しません。

一部の MSP では、同じストリームで同時に選択できる端末数が一定以上ない場合がありますが、インターフェイス自体ではそのような制限は適用されません。 同じストリームで一度に複数の端末を選択すると便利です。たとえば、1 組のスピーカーでストリームをリッスンしながら、受信オーディオ ストリームをファイルに記録できます。

特定のターミナルは、1 つのストリームにのみ選択できます。

要件

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

こちらもご覧ください

ITStream

メディア サービス プロバイダー インターフェイス (MSPI)