FltFreeCallbackData 関数 (fltkernel.h)

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

FltFreeCallbackData ルーチンは、FltAllocateCallbackData ルーチンによって割り当てられたコールバックデータ構造を解放します。

構文

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

パラメーター

[in] CallbackData

解放するコールバックデータ構造へのポインター。この FLT_CALLBACK_DATA 構造体は、 FltAllocateCallbackData の以前の呼び出しによって割り当てられている必要があります。このパラメーターは必須であり、 NULL にすることはできません。

戻り値

なし

解説

ミニフィルタードライバーは、FltAllocateCallbackData で以前に割り当て、FltPerformAsynchronousIo または FltPerformSynchronousIo の呼び出しで使用したコールバックデータ構造 (FLT_CALLBACK_DATA) でのみ FltFreeCallbackData を使用する必要があります。

特に、ミニフィルタードライバー自体によって割り当てられないコールバックデータ構造には、このルーチンを使用しないでください。

FltFreeCallbackData ルーチンは、指定された CallbackData オブジェクトに関連付けられている MDL チェーンを解放します。 FLT_CALLBACK_DATA オブジェクトに関連付けられている MDL チェーンへのポインターは、そのオブジェクトに対する FltFreeCallbackData の呼び出し後に無効になります。