EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP funzione di callback (wdfchildlist.h)

Articolo
02/29/2024

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtChildListAddressDescriptionCleanup libera le allocazioni di memoria per una descrizione dell'indirizzo allocata dalla funzione di callback evtChildListAddressDescriptionDuplicate .

Sintassi

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

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

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

[in, out] AddressDescription

Puntatore a una struttura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER che identifica una descrizione dell'indirizzo.

Valore restituito

nessuno

Osservazioni

Se un driver del bus usa l'enumerazione dinamica, può registrare una funzione di callback EvtChildListAddressDescriptionCleanup chiamando WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

Se una descrizione degli indirizzi punta a informazioni aggiuntive archiviate in memoria allocata dinamicamente e se tale memoria viene allocata da una funzione di callback EvtChildListAddressDescriptionDuplicate , il driver deve fornire una funzione di callback EvtChildListAddressDescriptionCleanup .

In genere, la funzione di callback EvtChildListAddressDescriptionDuplicate alloca memoria chiamando ExAllocatePool. La funzione di callback EvtChildListAddressDescriptionCleanup deve deallocare tale memoria chiamando ExFreePool. Questa funzione di callback non deve tentare di deallocare il resto della descrizione dell'indirizzo. In altre parole, la funzione callback non deve deallocare la struttura di descrizione degli indirizzi a cui punta il parametro AddressDescription ; deve deallocare solo le allocazioni di memoria aggiuntive a cui punta la struttura di descrizione.

Per altre informazioni sull'enumerazione dinamica, vedere Enumerazione dei dispositivi in un bus.