PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE コールバック関数 (fltkernel.h)

[アーティクル]
03/05/2024

ミニフィルタードライバーは、 FILE_LOCK 構造体のミニフィルタードライバーの CompleteLockCallbackDataRoutine コールバックルーチンとして PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE 型のルーチンを登録できます。

構文

PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE PfltCompleteLockCallbackDataRoutine;

NTSTATUS PfltCompleteLockCallbackDataRoutine(
  [in, optional] PVOID Context,
  [in]           PFLT_CALLBACK_DATA CallbackData
)
{...}

パラメーター

[in, optional] Context

FltProcessFileLock に渡されたコンテキストポインター。

[in] CallbackData

完了しているIRP_MJ_LOCK_CONTROL操作のコールバックデータ ( FLT_CALLBACK_DATA ) 構造体へのポインター。ロック要求の種類は、次のいずれかになります。

IRP_MN_LOCK
IRP_MN_UNLOCK_ALL
IRP_MN_UNLOCK_ALL_BY_KEY
IRP_MN_UNLOCK_SINGLE

戻り値

このルーチンは、STATUS_SUCCESSまたは適切な NTSTATUS 値を返します。成功コードではない NTSTATUS 値を返す場合、ファイルロックはファイルから削除されます。

注釈

ミニフィルタードライバーは、必要に応じて、バイト範囲ファイルロックのミニフィルタードライバーの CompleteLockCallbackDataRoutineルーチンとしてPFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE型のルーチンを指定できます。このルーチンを指定するために、ミニフィルタードライバーは、FltAllocateFileLock の CompleteLockCallbackDataRoutine パラメーターとしてルーチンへのポインターを渡します。

ファイルロックの IRP_MJ_LOCK_CONTROL 操作を完了すると、フィルターマネージャーはミニフィルターへの通知として、指定されている場合にこのルーチンを呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows XP SP2
サポートされている最小のサーバー	Windows Server 2003 SP1
対象プラットフォーム	デスクトップ
Header	fltkernel.h (Fltkernel.h を含む)
IRQL	<=APC_LEVEL