IGraphConfig::SetFilterFlags
SetFilterFlags メソッドは、フィルタの構成情報を設定する。
構文
HRESULT SetFilterFlags(
IBaseFilter *pFilter,
DWORD dwFlags
);
パラメータ
pFilter
[in] フィルタ グラフのフィルタへのポインタ。
dwFlags
[in] 新しい構成フラグを指定する値。次のいずれかの値でなければならない。
値 | 説明 |
ゼロ (0) | フラグを設定しない。 |
AM_FILTER_FLAGS_REMOVABLE | 動的な再接続の間にフィルタを削除できる。詳細については、「注意」を参照すること。 |
戻り値
次のいずれかの HRESULT 値を返す。
値 | 説明 |
E_POINTER | NULL ポインタ引数。 |
E_INVALIDARG | 無効な引数。 |
S_OK | 成功。 |
VFW_E_NOT_IN_GRAPH | フィルタがグラフに含まれていない。 |
注意
AM_FILTER_FLAGS_REMOVABLE フラグは、IGraphConfig::Reconnect メソッドの動作を変更する。Reconnect メソッドは、2 つのピンの間の動的な再接続を実行する。一方のピンだけを指定し、もう一方のピンを指定しなかった場合、Reconnect は指定されたピンからアップストリームまたはダウンストリームに向かって適切なピンを検索する。ただしデフォルトでは、IFilterGraph::AddFilter メソッドでグラフに追加したフィルタが見つかると検索が失敗する。この動作をオーバーライドするには、SetFilterFlags を呼び出してフィルタの AM_FILTER_FLAGS_REMOVABLE フラグを設定する。
参照