FltInitializeFileLock 函数 (fltkernel.h)

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

语法

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

参数

[out] FileLock

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

返回值

没有

言论

FILE_LOCK 结构不透明:即,其成员保留供系统使用。

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

对于已由 FltInitializeFileLockFltAllocateFileLock初始化的 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)
FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FILE_LOCK

FltAllocateFileLock

FltCheckLockForReadAccess

FltCheckLockForWriteAccess

FltFreeFileLock

FltProcessFileLock

FltUninitializeFileLock

FsRtlInitializeFileLock