FltFreeCallbackData-Funktion (fltkernel.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | fltkernel.h (include Fltkernel.h) |
| Bibliothek | FltMgr.lib |
| IRQL | <= DISPATCH_LEVEL |