FltGetFileContext 関数 (fltkernel.h)

[アーティクル]
04/27/2023

FltGetFileContext ルーチンは、特定のミニフィルタードライバーインスタンスによってファイルに設定されたコンテキストを取得します。

構文

NTSTATUS FLTAPI FltGetFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンスポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] FileObject

ファイルのファイルオブジェクトポインター。このパラメーターは必須であり、 NULL にすることはできません。

[out] Context

コンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。このパラメーターは必須であり、NULL に設定することはできません。

戻り値

FltGetFileContext は、要求されたファイルコンテキストを正常に返したときにSTATUS_SUCCESSを返します。それ以外の場合は、次のいずれかの適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_FOUND	現時点では、このファイルに一致するコンテキストが見つからなかったため、 FltMgr は Context をNULL_CONTEXTに設定しました。これはエラーコードです。
STATUS_NOT_SUPPORTED	このファイルでは、ファイルコンテキストはサポートされていません。これはエラーコードです。

注釈

コンテキストの詳細については、「ミニフィルターコンテキストについて」を参照してください。

ミニフィルタードライバーは 、FltGetFileContext を呼び出して、特定のファイルに対して設定されたファイルコンテキストを取得します。

FltGetFileContext は、 Context パラメーターが指すコンテキストの参照カウントをインクリメントします。このコンテキストポインターが不要になった場合、呼び出し元は FltReleaseContext を呼び出して参照カウントをデクリメントする必要があります。したがって、 FltGetFileContext を正常に呼び出すたびに、 FltReleaseContext の後続の呼び出しと一致する必要があります。

ファイルコンテキストを設定するには、 FltSetFileContext を呼び出します。

新しいコンテキストを割り当てるには、 FltAllocateContext を呼び出します。

ファイルコンテキストを削除するには、 FltDeleteFileContext または FltDeleteContext を呼び出します。

特定のファイルに対してファイルコンテキストがサポートされているかどうかを確認するには、 FltSupportsFileContexts または FltSupportsFileContextsEx を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL