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表示已授與要求的篩選 oplock。對於 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要求，且已在作業的 create options 參數中指定FILE_OPEN_REQUIRING_OPLOCK。 STATUS_CANNOT_BREAK_OPLOCK是成功的程序代碼。

文件系統和舊版篩選驅動程式會呼叫 FsRtlOplockFsctrl，以針對建立或文件系統控制 I/O 作業執行各種 oplock 作業。小型篩選程序應該呼叫 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 和一般機會鎖定的詳細資訊，請參閱 windows SDK Microsoft檔。

如果 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。

如果已授與擱置篩選作業鎖定的要求，FsRtlOplockFsctrl 會傳回STATUS_SUCCESS。如需建立參數的詳細資訊，請參閱 IRP_MJ_CREATE的參考專案。

呼叫此函式的篩選和文件系統必須將呼叫同步處理至系統提供的 oplock 套件。如需詳細資訊，請參閱 Oplock 同步處理。