FltFreeCallbackData, fonction (fltkernel.h)
La routine FltFreeCallbackData libère une structure de données de rappel allouée par la routine FltAllocateCallbackData.
Syntaxe
VOID FLTAPI FltFreeCallbackData(
[in] PFLT_CALLBACK_DATA CallbackData
);
Paramètres
[in] CallbackData
Pointeur vers la structure de données de rappel à libérer. Cette structure FLT_CALLBACK_DATA doit avoir été allouée par un appel précédent à FltAllocateCallbackData. Ce paramètre est obligatoire et ne peut pas être NULL.
Valeur de retour
Aucun
Remarques
Un pilote minifilter doit utiliser FltFreeCallbackData uniquement sur une structure de données de rappel (FLT_CALLBACK_DATA) qu’elle a précédemment allouée avec FltAllocateCallbackData et utilisée dans un appel à FltPerformAsynchronousIo ou FltPerformSynchronousIo.
En particulier, un pilote minifilter ne doit pas utiliser cette routine pour les structures de données de rappel qui n’ont pas été allouées par le pilote minifilter lui-même.
La routine FltFreeCallbackData libère toute chaîne MDL associée à l’objet CallbackData fourni. Un pointeur vers une chaîne MDL associée à un objet FLT_CALLBACK_DATA n’est pas valide après un appel à FltFreeCallbackData pour cet objet.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| IRQL | <= DISPATCH_LEVEL |