FltFreeCallbackData 関数 (fltkernel.h)

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 の呼び出し後に無効になります。

要件

要件
対象プラットフォーム ユニバーサル
Header fltkernel.h (Fltkernel.h を含む)
Library FltMgr.lib
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

FLT_CALLBACK_DATA

FltAllocateCallbackData

FltPerformAsynchronousIo

FltPerformSynchronousIo

FltReuseCallbackData