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

  • [アーティクル]

UnselectTerminal メソッドは、ストリームからターミナルの選択を解除し、このストリームのストリーミングを停止します。

構文

HRESULT UnselectTerminal(
  [in] ITTerminal *pTerminal
);

パラメーター

[in] pTerminal

ストリームから削除する ITTerminal インターフェイス ターミナルへのポインター。

戻り値

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

値 説明
S_OK
 メソッドが成功しました。
E_POINTER
 pTerminal パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。
TAPI_E_INVALIDTERMINAL
 pTerminal パラメーターは、有効なターミナルを指していません。
TAPI_E_NOTSUPPORTED
 プロバイダーはこの操作をサポートしていません。

解説

一部のストリーム イベントは、送信の遅延が原因でストリーミングが停止した後に受信される場合があります。

ストリームから最後のターミナルの選択を解除すると、この特定のストリームの既存のストリーミングが実質的に停止します。 その後、同じターミナルまたは別のターミナルを選択すると、このような中断されたストリーミングが再起動されます。

別のターミナルまたは新しく作成されたターミナルを使用してストリームに再選択すると、予期しない影響を受ける可能性があります。 フィルター グラフには、新しいターミナルと一致しない前のターミナルからの情報が保持される場合があります。

要件

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

関連項目

ITStream

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