FsRtlTeardownPerFileContexts 関数 (ntifs.h)

ファイル システムはFsRtlTeardownPerFileContexts ルーチンを呼び出して、ファイル制御ブロック (FCB) 構造に関連付けられているFSRTL_PER_FILE_CONTEXTオブジェクトを解放します。

構文

void FsRtlTeardownPerFileContexts(
  [in] PVOID *PerFileContextPointer
);

パラメーター

[in] PerFileContextPointer

ファイルごとのコンテキスト構造を識別する不透明なポインターへのポインター。 ファイル オブジェクトからこのポインターを取得するには、 FsRtlGetPerFileContextPointer マクロを使用します。

戻り値

なし

解説

このルーチンは、FSRTL_PER_FILE_CONTEXT オブジェクトで指定された FreeCallback ルーチンを呼び出します。 FreeCallback ルーチンは、FSRTL_PER_FILE_CONTEXT構造体と関連するコンテキストの割り当てを解除する必要があります。

同期の競合を回避するために、FsRtlTeardownPerFileContexts ルーチンは、FreeCallback を呼び出す前に、ファイル ごとのコンテキスト オブジェクトのロックを解除します。 これにより、 FsRtlRemovePerFileContext を使用した削除など、独自のリスト操作のフィルターによって、 ファイルごとのコンテキスト オブジェクトへの アクセスがブロックされるのを回避できます。

要件

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

こちらもご覧ください

FSRTL_PER_FILE_CONTEXT

PFREE_FUNCTION

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