次の方法で共有

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
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (FltKernel.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer の

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

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