FltOplockFsctrlEx 函数（fltkernel.h）

项目
12/21/2024

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的行为。标志参数具有以下选项：

价值	意义
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 代码在 FsControlCode 操作 FLT_PARAMETERS 结构的成员中设置。有关 FsControlCode 和其他IRP_MJ_FILE_SYSTEM_CONTROL参数的详细信息，请参阅 FLT_PARAMETERS 了解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_CREATEFLT_PARAMETERS。
IRP_MJ_CREATE操作的 ShareAccess 参数的值FILE_SHARE_READ、FILE_SHARE_WRITE或FILE_SHARE_DELETE。此参数在操作FLT_PARAMETERS结构的 ShareAccess 成员中设置。有关详细信息，请参阅IRP_MJ_CREATEFLT_PARAMETERS。

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

要求

要求	价值
最低支持的客户端	此例程从 Windows 8 开始可用。
目标平台	普遍
标头	fltkernel.h （包括 Fltkernel.h）
库	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL