FltOplockBreakH 関数 (fltkernel.h)

FltOplockBreakH ルーチンは、日和見ロック (oplocks) CACHE_HANDLE_LEVEL中断します。

構文

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

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

[in] CallbackData

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

[in] Flags

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

OPLOCK_FLAG_COMPLETE_IF_OPLOCKED (0x00000001)

oplock 中断の原因となった操作をブロックまたは保留せずに、oplock の中断を続行できるようにします。

OPLOCK_FLAG_IGNORE_OPLOCK_KEYS (0x00000008)

oplock キー CACHE_HANDLE_LEVEL関係なく、oplock の中断を続行できるようにします。

[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 操作のコールバック データ構造へのポインター。

文脈

FltOplockBreakH をするために、Context パラメーターで渡されたコンテキスト情報ポインター。

[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 操作のコールバック データ構造へのポインター。

文脈

FltOplockBreakH をするために、Context パラメーターで渡されたコンテキスト情報ポインター。

戻り値

FltOplockBreakH は、次のFLT_PREOP_CALLBACK_STATUS コードのいずれかを返します。

備考

日和見ロックの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

関連項目

FLT_CALLBACK_DATA

FltInitializeOplock の

FsRtlOplockBreakH

IO_STATUS_BLOCK