FsRtlOplockBreakToNoneEx 函式 （ntifs.h）

FsRtlOplockBreakToNoneEx 例程會立即中斷所有機會鎖定 （oplocks），而不考慮任何 oplock 密鑰。

語法

NTSTATUS FsRtlOplockBreakToNoneEx(
  [in, out]      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, out] Oplock

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

[in] Irp

I/O 作業之 IRP 的指標。

[in] Flags

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

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED（0x00000001）

指定允許 oplock 中斷繼續，而不會封鎖或擱置造成 oplock 中斷的作業。 一般而言，只有當 Irp 參數指向的 IRP 宣告IRP_MJ_CREATE作業時，才會使用此旗標。

[in, optional] Context

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

[in, optional] CompletionRoutine

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

此例程宣告如下：

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

此例程具有下列參數：

上下文

傳遞至 Context 參數的內容資訊指標，FsRtlOplockBreakToNoneEx。

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 參數的內容資訊指標，FsRtlOplockBreakToNoneEx。

Irp

I/O 作業之 IRP 的指標。

傳回值

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

言論

如需機會鎖定的詳細資訊，請參閱 Microsoft Windows SDK 檔。

Minifilters 應該呼叫 FltOplockBreakToNoneEx，而不是 FsRtlOplockBreakToNoneEx。

要求

另請參閱

FltOplockBreakToNoneEx

FsRtlInitializeOplock