FsRtlOplockFsctrl 函数（ntifs.h）

FsRtlOplockFsctrl 代表文件系统或筛选器驱动程序执行各种机会锁（oplock）操作。

语法

NTSTATUS FsRtlOplockFsctrl(
  [in] POPLOCK Oplock,
  [in] PIRP    Irp,
  [in] ULONG   OpenCount
);

[in] Oplock

文件的不透明不透明锁指针。此指针必须由上一次调用来初始化 FsRtlInitializeOplock。

[in] Irp

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

[in] OpenCount

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

FsRtlOplockFsctrl 返回以下 NTSTATUS 值之一：

返回代码	描述
STATUS_SUCCESS	对于IRP_MJ_CREATE请求，STATUS_SUCCESS指示已授予请求的筛选器操作锁。对于 FSCTL 操作，STATUS_SUCCESS的含义取决于 FSCTL 代码。有关详细信息，请参阅以下“备注”部分中列出的 FSCTL 代码的参考页。
STATUS_CANCELLED	I/O 操作已取消。 STATUS_CANCELLED是错误代码。
STATUS_INVALID_PARAMETER	I/O 操作的 FSCTL 代码不是以下“备注”部分中列出的有效值之一。 STATUS_INVALID_PARAMETER是错误代码。
STATUS_OPLOCK_NOT_GRANTED	无法授予 oplock。 STATUS_OPLOCK_NOT_GRANTED是错误代码。
STATUS_PENDING	仅用于 FSCTL 操作。 STATUS_PENDING的含义取决于 FSCTL 代码。有关详细信息，请参阅以下“备注”部分中列出的 FSCTL 代码的参考页。 STATUS_PENDING是成功的代码。
STATUS_CANNOT_BREAK_OPLOCK	无法授予新的 oplock。 IRP 是一个IRP_MJ_CREATE请求，FILE_OPEN_REQUIRING_OPLOCK是在操作的 create options 参数中指定的。 STATUS_CANNOT_BREAK_OPLOCK是成功的代码。

文件系统和旧筛选器驱动程序调用 FsRtlOplockFsctrl 来执行各种操作，以便执行创建或文件系统控制 I/O 操作。微型筛选器应调用 FltOplockFsctrl，而不是 FsRtlOplockFsctrl。

Irp 参数指向的 IRP 必须是 IRP_MJ_FILE_SYSTEM_CONTROL 或 IRP_MJ_CREATE 操作的有效 IRP。

如果 IRP 是 IRP_MJ_FILE_SYSTEM_CONTROL 请求，FsRtlOplockFsctrl 可用于以下 FSCTL 代码之一，该代码在 IrpSp->Parameters.FileSystemControl.FsControlCode中设置：

有关这些 FSCTL 和一般机会锁的详细信息，请参阅 Microsoft Windows SDK 文档。

如果 IRP 是 IRP_MJ_CREATE 请求，则 FsRtlOplockFsctrl 可用于请求挂起的筛选器 oplock（如果满足以下所有条件）：

OpenCount 参数的值必须为 1。
IRP_MJ_CREATE请求的 DesiredAccess 参数的值必须FILE_READ_ATTRIBUTES。
IRP_MJ_CREATE请求的 ShareAccess 参数的值必须FILE_SHARE_READ |FILE_SHARE_WRITE |FILE_SHARE_DELETE。

如果授予挂起筛选器 oplock 的请求，FsRtlOplockFsctrl 返回STATUS_SUCCESS。有关创建参数的详细信息，请参阅 IRP_MJ_CREATE的参考条目。

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