FsRtlLookupPerFileContext 関数 (ntifs.h)

FsRtlLookupPerFileContext ルーチンは、指定したファイルに関連付けられているFSRTL_PER_FILE_CONTEXT オブジェクトへのポインターを返します。

構文

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

パラメーター

[in] PerFileContextPointer

ファイル システム ランタイム ライブラリ (FSRTL) パッケージがファイル コンテキストを追跡するために使用する不透明なポインターへのポインター。 ファイル オブジェクトからこのポインターを取得するには、 FsRtlGetPerFileContextPointer マクロを使用します。

[in, optional] OwnerId

ファイルごとのコンテキスト構造の所有者を一意に識別するフィルター ドライバーによって割り当てられた変数へのポインター。 この変数の形式は、フィルター ドライバー固有です。 このパラメーターは省略可能ですが、InstanceId が NULL 以外の場合は NULL 以外である必要があります。

[in, optional] InstanceId

同じフィルター ドライバーによって作成されるファイルごとのコンテキスト構造を区別するために使用できる、フィルター ドライバーによって割り当てられた変数へのポインター。 この変数の形式は、フィルター ドライバー固有です。 このパラメーターは省略できます。

戻り値

OwnerId と InstanceId に一致する最初のFSRTL_PER_FILE_CONTEXT構造体 (指定されている場合) へのポインター。一致するものが見つからない場合、またはファイル システムがファイルごとのコンテキストをサポートしていない場合は NULL。

注釈

OwnerID と InstanceId を指定しないことで、フィルター ドライバーはファイルに関連付けられている最初のコンテキストを検索できます。

ファイル システムがファイルごとのコンテキスト オブジェクトをサポートしていない場合は、 NULL が返されます。 FsRtlSupportsPerFileContexts マクロを使用して、ファイル システムがファイルごとのコンテキスト オブジェクトをサポートしているかどうかを判断します。

要件

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

こちらもご覧ください

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

レガシ ファイル システム フィルター ドライバーでの Per-File コンテキストの追跡