FsRtlOplockBreakH 函式 (ntifs.h)

  • 發行項

FsRtlOplockBreakH 例程會中斷CACHE_HANDLE_LEVEL作業鎖定 (oplocks) 。

語法

NTSTATUS FsRtlOplockBreakH(
  [in]           POPLOCK                       Oplock,
  [in]           PIRP                          Irp,
  [in]           ULONG                         Flags,
  [in, optional] PVOID                         Context,
  [in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
  [in, optional] POPLOCK_FS_PREPOST_IRP        PostIrpRoutine
);

參數

[in] Oplock

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

[in] Irp

I/O 作業之 IRP 的指標。

[in] Flags

相關聯檔案 I/O 作業的位掩碼。 文件系統或篩選驅動程式會設定位，以指定 FsRtlOplockBreakH 的行為。 Flags 參數具有下列選項：

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

指定允許 oplock 中斷繼續，而不封鎖或擱置造成 oplock 中斷的作業。

OPLOCK_FLAG_IGNORE_OPLOCK_KEYS (0x00000008)

Windows 7 和更新版本支援。

指定允許不論 oplock 鍵為何，CACHE_HANDLE_LEVEL oplock 中斷都繼續。

[in, optional] Context

要傳遞至 CompletionRoutine 和 PostIrpRoutine 參數所指向之回呼例程之呼叫端定義內容資訊的指標。

[in, optional] CompletionRoutine

呼叫端提供的回呼例程指標。 如果作業鎖定中斷正在進行中，當中斷完成時，就會呼叫此例程。 此參數是選擇性的，可以是 NULL。 如果是 NULL，則呼叫端會進入等候狀態，直到作業鎖定中斷完成為止。

此例程宣告如下：

typedef VOID
(*POPLOCK_WAIT_COMPLETE_ROUTINE) (
      IN PVOID Context,
      IN PIRP Irp
      );

此例程具有下列參數：

Context

在 Context 參數中傳遞至 FsRtlOplockBreakH的內容資訊指標。

Irp

I/O 作業之 IRP 的指標。

[in, optional] PostIrpRoutine

如果要寫入 I/O 作業，則呼叫端提供的回呼例程指標。 此例程會在 oplock 套件畫上 IRP 之前呼叫。 此參數是選擇性的，可以是 NULL。

此例程宣告如下：

typedef VOID
(*POPLOCK_FS_PREPOST_IRP) (
      IN PVOID Context,
      IN PIRP Irp
      );

Context

在 Context 參數中傳遞至 FsRtlOplockBreakH的內容資訊指標。

Irp

I/O 作業之 IRP 的指標。

傳回值

FsRtlOplockBreakH 會傳回STATUS_SUCCESS或適當的 NTSTATUS 程式代碼，例如下列其中一項：

傳回碼 Description
STATUS_CANCELLED
 IRP 已取消。 STATUS_CANCELLED是錯誤碼。
STATUS_PENDING
 IRP 已張貼到工作佇列。 STATUS_PENDING是成功的程序代碼。
STATUS_CANNOT_BREAK_OPLOCK
 無法完成作業鎖定 (作業鎖定) 中斷。 IRP 是IRP_MJ_CREATE要求。 FILE_OPEN_REQUIRING_OPLOCK是在作業的 create options 參數中指定，而且有授與的 oplock。 STATUS_CANNOT_BREAK_OPLOCK是錯誤碼。

備註

當作業必須中斷CACHE_HANDLE_LEVEL oplock 時，作業會呼叫 FsRtlOplockBreakH。

如果呼叫端在 Flags 參數中指定OPLOCK_FLAG_IGNORE_OPLOCK_KEYS旗標， 則不論 oplock 機碼為何，FsRtlOplockBreakH 都會中斷所有CACHE_HANDLE_LEVEL oplock。 FsRtlOplockBreakH 的預設行為是中斷索引鍵不符合呼叫端檔案物件上索引鍵的 oplock。

Minifilters 應該呼叫 FltOplockBreakH ，而不是 FsRtlOplockBreakH。

規格需求

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

另請參閱

FltOplockBreakH

FsRtlInitializeOplock