EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP fonction de rappel (wdfchildlist.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La fonction de rappel d’événement evtChildListIdentificationDescriptionCleanup du pilote libère toutes les allocations de mémoire pour une description d’identification allouée par la fonction de rappel EvtChildListIdentificationDescriptionDuplicate fonction de rappel allouée.

Syntaxe

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

void EvtWdfChildListIdentificationDescriptionCleanup(
  [in]      WDFCHILDLIST ChildList,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
)
{...}

Paramètres

[in] ChildList

Handle d’un objet de liste enfant de framework.

[in, out] IdentificationDescription

Pointeur vers une structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER qui identifie une description d’identification.

Valeur de retour

Aucun

Remarques

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

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

En règle générale, la fonction de rappel EvtChildListIdentificationDescriptionDuplicate alloue de la mémoire en appelant ExAllocatePool. La fonction de rappel EvtChildListIdentificationDescriptionCleanup 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’identification. En d’autres termes, la fonction de rappel ne doit pas libérer la structure de description de l’adresse vers laquelle pointe le paramètre IdentificationDescription ; 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.