FltOplockBreakToNoneEx 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltOplockBreakToNoneEx ルーチンは、oplock キーに関係なく、すべての日和見ロック (oplock) を直ちに中断します。

構文

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockBreakToNoneEx(
  [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

ファイルの不透明な oplock ポインター。このポインターは、 FltInitializeOplock の以前の呼び出しによって初期化されている必要があります。

[in] CallbackData

I/O 操作のコールバックデータ (FLT_CALLBACK_DATA) 構造体へのポインター。

[in] Flags

関連付けられたファイル I/O 操作のビットマスク。ミニフィルタードライバーは、 FltOplockBreakToNoneEx の動作を指定するビットを設定します。 Flags パラメーターには、次のオプションがあります。

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

oplock 中断の原因となった操作をブロックまたは保留中にせずに、oplock の中断を続行できるようにします。通常、このフラグは、 CallbackData パラメーターが指すコールバックデータによって表される I/O 操作がIRP_MJ_CREATE操作である場合にのみ使用されます。

[in, optional] Context

WaitCompletionRoutine パラメーターと PrePostCallbackDataRoutine パラメーターが指すコールバックルーチンに渡される呼び出し元定義のコンテキスト情報へのポインター。

[in, optional] WaitCompletionRoutine

呼び出し元が指定したコールバックルーチンへのポインター。 oplock ブレークが進行中の場合は、中断が完了したときにこのルーチンが呼び出されます。このパラメーターは省略可能であり、 NULL にすることができます。 NULL の場合、呼び出し元は oplock ブレークが完了するまで待機状態になります。

このルーチンは、次のように宣言されます。

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

このルーチンには、次のパラメーターがあります。

CallbackData

I/O 操作のコールバックデータ構造へのポインター。

Context

Context パラメーターで FltOplockBreakToNoneEx に渡されたコンテキスト情報ポインター。

[in, optional] PrePostCallbackDataRoutine

I/O 操作をペンドする場合に呼び出される呼び出し元が指定したコールバックルーチンへのポインター。ルーチンは、oplock パッケージが IRP をペンする前に呼び出されます。このパラメーターは省略可能であり、 NULL にすることができます。