FltInitializeFileLock 関数 (fltkernel.h)

[アーティクル]
02/29/2024

FltInitializeFileLock ルーチンは、呼び出し元がページプールから割り当てた不透明なFILE_LOCK構造体を初期化します。

構文

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

パラメーター

[out] FileLock

初期化されていない FILE_LOCK 構造体へのポインター。

戻り値

なし

解説

FILE_LOCK構造体は不透明です。つまり、そのメンバーはシステム使用のために予約されています。

初期化後、fltProcessFileLock を呼び出して、FILE_LOCK構造体を使用してファイル内のバイト範囲をロックできます。

FltInitializeFileLock または FltAllocateFileLock によって既に初期化されているFILE_LOCK構造体に対して FltInitializeFileLock を呼び出すと、その構造体が FltUninitializeFileLock の後続の呼び出しによって初期化されていない場合は、プログラミングエラーになります。

FILE_LOCK構造体が不要になった場合は、FltUninitializeFileLock を呼び出すことで初期化解除できます。初期化されていない FILE_LOCK 構造体は、 FltInitializeFileLock を呼び出すことで再利用できるように初期化できます。

新しい不透明な FILE_LOCK 構造体を割り当てて初期化するには、 FltAllocateFileLock を呼び出します。

初期化された FILE_LOCK 構造体を解放するには、 FltFreeFileLock を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows XP SP2
サポートされている最小のサーバー	Windows Server 2003 SP1
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL