FsRtlOplockFsctrlEx 函式 (ntifs.h)

FsRtlOplockFsctrlEx 例程會代表文件系統或篩選驅動程式執行各種作業 (oplock) 作業。

語法

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

[in] Oplock

檔案的不透明不透明指標。此指標必須由 先前對 FsRtlInitializeOplock 的呼叫初始化。

[in] Irp

I/O 作業的 IRP 指標。這個參數是必要的，而且不能是 NULL。

[in] OpenCount

如果要求獨佔的 oplock，檔案的使用者句柄數目。設定層級 2、R 或 RH oplock 要求的非零值表示檔案上有位元組範圍鎖定。如需 oplock 類型的相關信息，請參閱 Oplock 概觀。

[in] Flags

相關聯 oplock 作業的位掩碼。文件系統或篩選驅動程式會設定位，以指定 FsRtlOplockFsctrlEx 的行為。此參數具有下列選項：

旗標	意義
OPLOCK_FSCTRL_FLAG_ALL_KEYS_MATCH (0x00000001)	檔系統已確認任何目前開啟句柄上的所有 oplock 機碼都相符。藉由指定此旗標，您可以在檔案存在多個開啟句柄時，允許 oplock 套件授與層級 RW 或 RWH 的 oplock。如需 oplock 類型的詳細資訊，請參閱 Oplock 概觀。

FsRtlOplockFsctrlEx 會傳回下列其中一個 NTSTATUS 值：

傳回碼	Description
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是成功的程序代碼。

文件系統和舊版篩選驅動程式會呼叫 FsRtlOplockFsctrlEx ，以針對建立或文件系統控制 I/O 作業執行各種 oplock 作業。 Minifilters 應該呼叫 FltOplockFsctrlEx ，而不是 FsRtlOplockFsctrlEx。

Irp 參數所指向的 IRP 必須是IRP_MJ_FILE_SYSTEM_CONTROL或 IRP_MJ_CREATE作業的有效 IRP。

如果 IRP 是IRP_MJ_FILE_SYSTEM_CONTROL要求，FsRtlOplockFsctrlEx 可以搭配下列其中一個 FSCTL 程式代碼使用，此程式代碼是在 IrpSp-Parameters.FileSystemControl.FsControlCode> 中設定：

如需這些 FSCTL 和一般操作鎖定的詳細資訊，請參閱 Microsoft Windows SDK 檔。

如果 IRP 是IRP_MJ_CREATE要求，如果下列所有條件都成立， 可以使用 FsRtlOplockFsctrlEx 來要求擱置篩選 oplock：

OpenCount 參數的值必須是 1。
IRP_MJ_CREATE要求的 DesiredAccess 參數值必須FILE_READ_ATTRIBUTES。
IRP_MJ_CREATE要求的 ShareAccess 參數值必須FILE_SHARE_READ |FILE_SHARE_WRITE |FILE_SHARE_DELETE。

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

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

需求	值
最低支援的用戶端	FsRtlOplockFsctrlEx 例程從 Windows 7 開始可供使用。
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL