IFilterGraph::RemoveFilter
RemoveFilter メソッドは、フィルタ グラフからフィルタを削除する。
構文
HRESULT RemoveFilter(
IBaseFilter *pFilter
);
パラメータ
pFilter
[in] グラフから削除するフィルタへのポインタ。
戻り値
次のいずれかの値を返す。
値 | 説明 |
S_OK | 成功。 |
E_FAIL | 失敗。 |
E_POINTER | NULL ポインタ引数。 |
注意
フィルタ グラフ マネージャは、引数 NULL でフィルタの IBaseFilter::JoinFilterGraph メソッドを呼び出して、フィルタが削除されることをそのフィルタに通知する。
RemoveFilter を呼び出す前にフィルタのピンを切り離す必要はないが、フィルタ グラフを停止状態にする必要がある。フィルタが停止していないと、RemoveFilter はピンとの切り離しに失敗し、グラフからのフィルタの削除に失敗するかもしれない。IGraphConfig::RemoveFilterEx を使うと、アプリケーションはピンとの切り離しなしにフィルタを自動的に削除できる。これによって、接続されているフィルタを新しいグラフに移動したい場合にパフォーマンスが向上する。
参照