FltOplockBreakToNone 函式 (fltkernel.h)

發行項
02/26/2024

FltOplockBreakToNone 例程會立即中斷 oplocks (oplocks) 所有不考慮任何 oplock 索引鍵的商機鎖定。

語法

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockBreakToNone(
  [in]           POPLOCK                                 Oplock,
  [in]           PFLT_CALLBACK_DATA                      CallbackData,
  [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, 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 參數中傳遞至 FltOplockBreakToNone 的內容資訊指標。

[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 參數中傳遞至 FltOplockBreakToNone 的內容資訊指標。

傳回值

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

傳回碼	Description
FLT_PREOP_COMPLETE	FltOplockBreakToNone 發生集區配置失敗，或呼叫 FsRtlOplockBreakToNoneEx 函式傳回錯誤。 FltOplockBreakToNone 會在 IoStatus成員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 作業。

備註

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

規格需求

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