Fonction FltFreeCallbackData (fltkernel.h)

Article
03/05/2024

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

None

Remarques

Un pilote minifilter doit utiliser FltFreeCallbackData uniquement sur une structure de données de rappel (FLT_CALLBACK_DATA) qu’il 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 ne sera pas valide après un appel à FltFreeCallbackData pour cet objet.