FsRtlAreThereCurrentFileLocks 宏 (ntifs.h)

项目
02/29/2024

FsRtlAreThereCurrentFileLocks 宏检查指定文件是否存在任何字节范围锁。

语法

void FsRtlAreThereCurrentFileLocks(
   FL
);

参数

FL

指向文件的 FILE_LOCK 结构的指针。此结构必须已由之前对 FsRtlAllocateFileLock 或 FsRtlInitializeFileLock 的调用初始化。

返回值

无

备注

此宏的作用类似于 BOOLEAN 函数，如果指定文件存在任何字节范围锁，则返回 TRUE;如果不存在任何字节范围锁，则返回 FALSE。

文件系统和筛选器驱动程序通常从其 FastIoCheckIfPossible 例程调用 FsRtlAreThereCurrentFileLocks。

如果自打开指定文件以来存在字节范围锁， FsRtlAreThereCurrentFileLocks 将返回 TRUE，除非重新初始化相关 FILE_LOCK 。如果已建立并释放锁，则使用 FsRtlAreThereCurrentFileLocks 可能会不必要地阻止 oplock 的分配。使用 FsRtlAreThereCurrentOrInProgressFileLocks 可避免此问题。