fltInitializeFileLock 函数 (fltkernel.h)

项目
02/29/2024

FltInitializeFileLock 例程初始化调用方从分页池中分配的不透明FILE_LOCK结构。

语法

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

参数

[out] FileLock

指向未初始化 FILE_LOCK 结构的指针。

返回值

无

备注

FILE_LOCK结构是不透明的：也就是说，其成员保留供系统使用。

初始化后， FILE_LOCK 结构可用于通过调用 FltProcessFileLock 锁定文件中的字节范围。

为已由 FltInitializeFileLock 或 FltAllocateFileLock 初始化的 FILE_LOCK 结构调用 FltInitializeFileLock 是一个编程错误，除非后续调用 FltUninitializeFileLock 未初始化该结构。

不再需要 FILE_LOCK 结构时，可以通过调用 FltUninitializeFileLock 将其取消初始化。然后，可以通过调用 FltInitializeFileLock 来初始化未初始化FILE_LOCK结构以供重复使用。

若要分配和初始化新的不透明 FILE_LOCK 结构，请调用 FltAllocateFileLock。

若要释放已初始化 FILE_LOCK 结构，请调用 FltFreeFileLock。

要求

要求	值
最低受支持的客户端	Windows XP SP2
最低受支持的服务器	Windows Server 2003 SP1
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL