FltGetInstanceContext 関数 (fltkernel.h)

[アーティクル]
02/26/2024

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

構文

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

パラメーター

[in] Instance

インスタンスの不透明なインスタンスポインター。

[out] Context

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

戻り値

FltGetInstanceContext は、要求されたインスタンスコンテキストを正常に返したときにSTATUS_SUCCESSを返します。それ以外の場合は、次のような適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_FOUND	現時点では、このインスタンスで一致するコンテキストが見つかりませんでした。 FltMgr は、コンテキストをNULL_CONTEXTに設定します。これはエラーコードです。

注釈

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

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

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

インスタンスのコンテキストを設定するには、 FltSetInstanceContext を呼び出します。

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

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

要件

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