IFilterChain インターフェイス

IFilterChain インターフェイスは、フィルタ グラフのフィルタ チェーンを開始、停止、削除するメソッドを提供する。フィルタ グラフ マネージャはこのインターフェイスを公開する。

フィルタ チェーンは、一連のフィルタから成る 1 つの連続したフィルタである。個々のフィルタには最大 1 つの入力ピンと 1 つの出力ピンが接続される。フィルタ チェーンは、チェーン先頭フィルタとチェーン終端フィルタにより定義される (先頭フィルタと終端フィルタが同じ場合は、フィルタを 1 つだけ含むチェーンとなる)。定義によって、チェーンの先頭からダウンストリームで終端まで続く単一のストリーム パスができる。

このインターフェイスのメソッドは、ネットワーク経由で複数のストリームを受信するテレビ会議アプリケーションのように、データ ストリーム全体が現れたり消えたりする場合に利用する。詳細については、「動的グラフ作成」を参照すること。キャプチャ フィルタ上の個々のストリームを制御するには、このインターフェイスではなく、IAMStreamControl インターフェイスを使う。

IFilterChain インターフェイスは、IUnknown から継承するメソッド以外に以下のメソッドも公開する。

メソッド	説明
StartChain	フィルタ チェーンのフィルタをすべて実行状態に切り替える。
StopChain	フィルタ チェーンのフィルタをすべて停止状態に切り替える。
RemoveChain	フィルタ チェーンのフィルタをすべてフィルタ グラフから削除する。
PauseChain	フィルタ チェーンのフィルタをすべてポーズ状態に切り替える。