IFilterGraph::FindFilterByName
FindFilterByName メソッドは、指定された名前でフィルタ グラフに追加されたフィルタを検索する。
構文
HRESULT FindFilterByName(
LPCWSTR pName,
IBaseFilter **ppFilter
);
パラメータ
pName
[in, string] 検索する名前へのポインタ。
ppFilter
[out] フィルタの IBaseFilter インターフェイスへのポインタを受け取る変数のアドレス。
[out] 見つかったフィルタの IBaseFilter インターフェイスへのポインタのアドレス。
戻り値
次のいずれかの値を返す。
| 値 | 説明 |
| S_OK | 成功。 |
| E_POINTER | NULL ポインタ引数。 |
| VFW_E_NOT_FOUND | 指定された名前のフィルタが見つからなかった。 |
注意
フィルタが見つからない場合、メソッドは ppFilter 引数に NULL ポインタを返す。
返される IBaseFilter インターフェイスに未処理の参照カウントが残る。呼び出し元はそのインターフェイスを解放しなければならない。
参照