FltFreeCallbackData-Funktion (fltkernel.h)
Die FltFreeCallbackData Routine gibt eine Rückrufdatenstruktur frei, die der FltAllocateCallbackData Routine zugeordnet ist.
Syntax
VOID FLTAPI FltFreeCallbackData(
[in] PFLT_CALLBACK_DATA CallbackData
);
Parameter
[in] CallbackData
Zeigen Sie auf die Rückrufdatenstruktur, die freigegeben werden soll. Diese FLT_CALLBACK_DATA Struktur muss durch einen vorherigen Aufruf von FltAllocateCallbackData-zugewiesen worden sein. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
Rückgabewert
Nichts
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 FltPerformSynchronousIoverwendet wurde.
Insbesondere sollte ein Minifiltertreiber diese Routine nicht für Rückrufdatenstrukturen verwenden, die vom Minifiltertreiber selbst nicht zugeordnet wurden.
Die FltFreeCallbackData Routine gibt jede MDL- Kette frei, die dem bereitgestellten 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- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| IRQL- | <= DISPATCH_LEVEL |