次の方法で共有

FltGetFilterFromName 関数 (fltkernel.h)

  • [アーティクル]

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 値を返します。

リターン コード 説明
STATUS_FLT_DELETING_OBJECT
 一致するミニフィルター ドライバーが見つかりましたが、取り壊されています。 これはエラー コードです。
STATUS_FLT_FILTER_NOT_FOUND
 一致するミニフィルター ドライバーが見つかりませんでした。 これはエラー コードです。

注釈

FltGetFilterFromName は、 RetFilter パラメーターで返される不透明なフィルター ポインターにランダウン参照を追加します。 このポインターが不要になった場合、呼び出し元は FltObjectDereference を呼び出してポインターを解放する必要があります。 したがって、 FltGetFilterFromName の呼び出しが成功するたびに、 FltObjectDereference の後続の呼び出しと一致する必要があります。

ミニフィルター ドライバーをフィルター マネージャーに登録するには、 FltRegisterFilter を呼び出します。

要件

要件 値
対象プラットフォーム ユニバーサル
Header fltkernel.h (Fltkernel.h を含む)
Library FltMgr.lib
[DLL] Fltmgr.sys
IRQL <= APC_LEVEL

こちらもご覧ください

FltObjectDereference

FltRegisterFilter

UNICODE_STRING