共用方式為


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

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

[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