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 |