次の方法で共有


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

関連項目

FSRTL_PER_FILE_CONTEXT

PFREE_FUNCTION

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