FltGetFilterFromName ルーチンは、名前が FilterName パラメーターの値と一致する登録済みのミニフィルター ドライバーの不透明なフィルター ポインターを返します。
構文
NTSTATUS FLTAPI FltGetFilterFromName(
[in] PCUNICODE_STRING FilterName,
[out] PFLT_FILTER *RetFilter
);
パラメーター
[in] FilterName
ミニフィルター ドライバー名を含む UNICODE_STRING 構造体へのポインター。 (名前の比較では大文字と小文字が区別されません)。
[out] RetFilter
名前が FilterName パラメーターの名前と一致するミニフィルター ドライバーの不透明なフィルター ポインターを受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは必須であり、NULL することはできません。
戻り値
FltGetFilterFromName は、STATUS_SUCCESSまたは次のいずれかの適切な NTSTATUS 値を返します。
| リターン コード | 形容 |
|---|---|
|
一致するミニフィルター ドライバーが見つかりましたが、取り壊されています。 これはエラー コードです。 |
|
一致するミニフィルター ドライバーが見つかりませんでした。 これはエラー コードです。 |
備考
FltGetFilterFromName 、RetFilter パラメーターで返される不透明なフィルター ポインターへのランダウン参照を追加します。 このポインターが不要になったら、呼び出し元は FltObjectDereference 呼び出してポインターを解放する必要があります。 したがって、FltGetFilterFromName 正常に呼び出されるたびに、FltObjectDereference への後続の呼び出し照合する必要があります。
ミニフィルター ドライバーをフィルター マネージャーに登録するには、FltRegisterFilter 呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fltkernel.h (Fltkernel.h を含む) |
| ライブラリ | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
関連項目
FltRegisterFilter の