ITStream::UnselectTerminal メソッド (tapi3if.h)
UnselectTerminal メソッドは、ストリームからターミナルの選択を解除し、このストリームのストリーミングを停止します。
構文
HRESULT UnselectTerminal(
[in] ITTerminal *pTerminal
);
パラメーター
[in] pTerminal
ストリームから削除する ITTerminal インターフェイス ターミナルへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
pTerminal パラメーターが有効なポインターではありません。 |
|
操作を実行するためのメモリが不足しています。 |
|
pTerminal パラメーターは、有効なターミナルを指していません。 |
|
プロバイダーはこの操作をサポートしていません。 |
解説
一部のストリーム イベントは、送信の遅延が原因でストリーミングが停止した後に受信される場合があります。
ストリームから最後のターミナルの選択を解除すると、この特定のストリームの既存のストリーミングが実質的に停止します。 その後、同じターミナルまたは別のターミナルを選択すると、このような中断されたストリーミングが再起動されます。
別のターミナルまたは新しく作成されたターミナルを使用してストリームに再選択すると、予期しない影響を受ける可能性があります。 フィルター グラフには、新しいターミナルと一致しない前のターミナルからの情報が保持される場合があります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |