EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP fonction de rappel (wdfchildlist.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La fonction de rappel d’événement EvtChildListAddressDescriptionCleanup du pilote libère toutes les allocations de mémoire pour une description d’adresse que la fonction de rappel EvtChildListAddressDescriptionDuplicate allouée au pilote.

Syntaxe

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

void EvtWdfChildListAddressDescriptionCleanup(
  [in]      WDFCHILDLIST ChildList,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
)
{...}

Paramètres

[in] ChildList

Handle d’un objet de liste enfant de framework.

[in, out] AddressDescription

Pointeur vers une structure WDF_CHILD_ADDRESS_DESCRIPTION_HEADER qui identifie une description d’adresse.

Valeur de retour

Aucun

Remarques

Si un pilote de bus utilise énumération dynamique, il peut inscrire une fonction de rappel EvtChildListAddressDescriptionCleanup en appelant WdfFdoInitSetDefaultChildListConfig ou WdfChildListCreate.

Si une description d’adresse pointe vers des informations supplémentaires stockées dans la mémoire allouée dynamiquement et si cette mémoire est allouée par un EvtChildListAddressDescriptionDuplicate fonction de rappel, le pilote doit fournir une fonction de rappel EvtChildListAddressDescriptionCleanup fonction de rappel.

En règle générale, la fonction de rappel EvtChildListAddressDescriptionDuplicate alloue de la mémoire en appelant ExAllocatePool. La fonction de rappel EvtChildListAddressDescriptionCleanup doit libérer cette mémoire en appelant ExFreePool. Cette fonction de rappel ne doit pas tenter de libérer le reste de la description de l’adresse. En d’autres termes, la fonction de rappel ne doit pas libérer la structure de description de l’adresse vers laquelle le paramètre AddressDescription pointe ; elle ne doit libérer que des allocations de mémoire supplémentaires vers laquelle la structure de description pointe.

Pour plus d’informations sur l’énumération dynamique, consultez énumération des appareils sur un bus.