FltOplockFsctrlEx 函数 (fltkernel.h)

项目
08/07/2023

FltOplockFsctrlEx 例程代表微筛选器驱动程序执行各种机会锁 (oplock) 操作。

语法

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockFsctrlEx(
  [in] POPLOCK            Oplock,
  [in] PFLT_CALLBACK_DATA CallbackData,
  [in] ULONG              OpenCount,
  [in] ULONG              Flags
);

参数

[in] Oplock

文件的不透明不锁定指针。此指针必须已由之前对 FltInitializeOplock 的调用初始化。

[in] CallbackData

指向 I/O 操作 FLT_CALLBACK_DATA 结构的指针。此参数是必需的，不能为 NULL。

[in] OpenCount

如果请求独占 oplock，则文件的用户句柄数。为级别 2、R 或 RH oplock 请求设置非零值表示文件上有字节范围锁。有关 oplock 类型的信息，请参阅 Oplock 概述。

[in] Flags

关联 oplock 操作的位掩码。微筛选器驱动程序设置位以指定 FltOplockFsctrlEx 的行为。 Flags 参数具有以下选项：

值	含义
OPLOCK_FSCTRL_FLAG_ALL_KEYS_MATCH (0x00000001)	文件系统验证了当前打开的任何句柄上的所有 oplock 键是否匹配。通过指定此标志，允许 oplock 包在文件的多个打开句柄存在时授予级别 RW 或 RWH 的 oplock。有关 oplock 类型的详细信息，请参阅 Oplock 概述。

返回值

FltOplockFsctrlEx 返回某些 FSCTL 操作FLT_PREOP_PENDING。有关详细信息，请参阅以下备注部分中列出的 FSCTL 代码的参考页。否则， FltOplockFsctrlEx 返回FLT_PREOP_COMPLETE。

注解

微筛选器驱动程序调用 FltOplockFsctrlEx ，以对创建操作或文件系统控制 I/O 操作执行各种机会锁定操作。

CallbackData 参数指向的FLT_CALLBACK_DATA结构必须表示基于 IRP 的IRP_MJ_FILE_SYSTEM_CONTROL或IRP_MJ_CREATE操作。

如果操作是IRP_MJ_FILE_SYSTEM_CONTROL操作，则 FltOplockFsctrlEx 可以与以下 FSCTL 代码一起使用：

FSCTL 代码在操作FLT_PARAMETERS结构的FsControlCode 成员中设置。有关 FsControlCode 和其他IRP_MJ_FILE_SYSTEM_CONTROL参数的详细信息，请参阅 FLT_PARAMETERS for IRP_MJ_FILE_SYSTEM_CONTROL。

有关机会锁的详细信息，请参阅Microsoft Windows SDK文档。

如果操作是 IRP_MJ_CREATE 请求，则 FltOplockFsctrl 可用于请求挂起的筛选器机会锁（如果满足以下所有条件）：

OpenCount 参数的值必须为 1。
IRP_MJ_CREATE请求的 DesiredAccess 参数的值FILE_READ_ATTRIBUTES。此参数在操作的 FLT_PARAMETERS 结构的 SecurityContext 成员中设置。有关详细信息，请参阅 IRP_MJ_CREATE FLT_PARAMETERS。
IRP_MJ_CREATE操作的 ShareAccess 参数的值为 FILE_SHARE_READ、FILE_SHARE_WRITE 或 FILE_SHARE_DELETE。此参数在操作的 FLT_PARAMETERS 结构的 ShareAccess 成员中设置。有关详细信息，请参阅 IRP_MJ_CREATE FLT_PARAMETERS。

调用此函数的筛选器和文件系统必须将调用同步到系统提供的 oplock 包中。有关详细信息，请参阅 Oplock 同步。

要求

要求	值
最低受支持的客户端	此例程从Windows 8开始可用。
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL