FltOplockBreakH 函式 (fltkernel.h)

發行項
02/26/2024

FltOplockBreakH 例程會中斷CACHE_HANDLE_LEVEL oplocks) (商機鎖定。

語法

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockBreakH(
  [in]           POPLOCK                                 Oplock,
  [in]           PFLT_CALLBACK_DATA                      CallbackData,
  [in]           ULONG                                   Flags,
  [in, optional] PVOID                                   Context,
  [in, optional] PFLTOPLOCK_WAIT_COMPLETE_ROUTINE        WaitCompletionRoutine,
  [in, optional] PFLTOPLOCK_PREPOST_CALLBACKDATA_ROUTINE PrePostCallbackDataRoutine
);

參數

[in] Oplock

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

[in] CallbackData

回呼數據的指標， (FLT_CALLBACK_DATA I/O 作業的) 結構。

[in] Flags

相關聯檔案 I/O 作業的位掩碼。迷你篩選驅動程式會設定位以指定 FltOplockBreakH 的行為。 Flags 參數具有下列選項：

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

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

OPLOCK_FLAG_IGNORE_OPLOCK_KEYS (0x00000008)

允許CACHE_HANDLE_LEVEL oplock 中斷，不論 oplock 金鑰為何，都能繼續。

[in, optional] Context

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

[in, optional] WaitCompletionRoutine

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

此例程宣告如下：

typedef VOID
(*PFLTOPLOCK_WAIT_COMPLETE_ROUTINE) (
    __in PFLT_CALLBACK_DATA CallbackData,
 __in_opt PVOID Context
    );

此例程具有下列參數：

CallbackData

I/O 作業之回呼數據結構的指標。

Context

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

[in, optional] PrePostCallbackDataRoutine

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

此例程宣告如下：

typedef VOID
(*PFLTOPLOCK_PREPOST_CALLBACKDATA_ROUTINE) (
    __in PFLT_CALLBACK_DATA CallbackData,
 __in_opt PVOID Context
      );

此例程具有下列參數：

CallbackData

I/O 作業之回呼數據結構的指標。

Context

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

傳回值

FltOplockBreakH 會傳回下列其中一個FLT_PREOP_CALLBACK_STATUS代碼：

傳回碼	Description
FLT_PREOP_COMPLETE	FltOplockBreakH 發生集區配置失敗，或呼叫 FsRtlOplockBreakH 函式傳回錯誤。 FltOplockBreakH 會在 IO_STATUS_BLOCK 結構的 Status 成員中設定錯誤碼。 IO_STATUS_BLOCK結構是在FLT_CALLBACK_DATA回呼數據結構的IoStatus成員中指定。 CallbackData 參數會指向這個FLT_CALLBACK_DATA。
FLT_PREOP_PENDING	已起始 oplock 中斷，這會導致篩選管理員將 I/O 作業張貼至工作佇列。 I/O 作業是由 CallbackData 參數指向的回呼數據表示。
FLT_PREOP_SUCCESS_WITH_CALLBACK	CallbackData 參數指向的回呼數據未畫筆，而且會立即執行 I/O 作業。請注意，如果在 Flags 參數中指定呼叫端OPLOCK_FLAG_COMPLETE_IF_OPLOCKED，即使 I/O 作業未寫入，oplock 中斷仍可能正在進行中。若要判斷這種情況，呼叫端應該在IO_STATUS_BLOCK結構的 Status 成員中檢查 STATUS_OPLOCK_BREAK_IN_PROGRESS 。 IO_STATUS_BLOCK結構是在FLT_CALLBACK_DATA回呼數據結構的IoStatus成員中指定。

備註

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

規格需求

需求	值
最低支援的用戶端	FltOplockBreakH 例程從 Windows 7 開始可供使用。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL