FltFreeCallbackData-Funktion (fltkernel.h)

Artikel
02/26/2024

Die FltFreeCallbackData-Routine gibt eine Rückrufdatenstruktur frei, die von der FltAllocateCallbackData-Routine zugeordnet ist.

Syntax

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parameter

[in] CallbackData

Zeiger auf die Rückrufdatenstruktur, die freigegeben werden soll. Diese FLT_CALLBACK_DATA-Struktur muss durch einen vorherigen Aufruf von FltAllocateCallbackData zugeordnet worden sein. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

Keine

Bemerkungen

Ein Minifiltertreiber sollte FltFreeCallbackData nur für eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) verwenden, die er zuvor FltAllocateCallbackData zugeordnet und in einem Aufruf von FltPerformAsynchronousIo oder FltPerformSynchronousIo verwendet hat.

Insbesondere sollte ein Minifiltertreiber diese Routine nicht für Rückrufdatenstrukturen verwenden, die nicht vom Minifiltertreiber selbst zugeordnet wurden.

Die FltFreeCallbackData-Routine gibt jede MDL-Kette frei, die dem angegebenen CallbackData-Objekt zugeordnet ist. Ein Zeiger auf eine MDL-Kette, die einem FLT_CALLBACK_DATA -Objekt zugeordnet ist, ist nach einem Aufruf von FltFreeCallbackData für dieses Objekt ungültig.