EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP funzione di callback (wdfchildlist.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

La funzione di callback di un driver EvtChildListAddressDescriptionCleanup libera tutte le allocazioni di memoria per una descrizione dell'indirizzo che il driver EvtChildListAddressDescriptionDuplicate funzione di callback allocata.

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 'enumerazione dinamica, può registrare un EvtChildListAddressDescriptionCleanup funzione di callback chiamando WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

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

In genere, la funzione EvtChildListAddressDescriptionDuplicate funzione di callback alloca memoria chiamando ExAllocatePool. La EvtChildListAddressDescriptionCleanup funzione di callback 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 di callback non deve deallocare la struttura di descrizione dell'indirizzo a cui punta il parametro AddressDescription ; deve deallocare solo allocazioni di memoria aggiuntive a cui punta la struttura della descrizione.

Per altre informazioni sull'enumerazione dinamica, vedere Enumerating the Devices on a Bus.