EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP funzione di callback (wdfchildlist.h)

Articolo
08/08/2023

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtChildListIdentificationDescriptionCleanup di un driver libera tutte le allocazioni di memoria per una descrizione di identificazione allocata dalla funzione di callback EvtChildListIdentificationDescriptionDuplicate del driver.

Sintassi

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

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

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

[in, out] IdentificationDescription

Puntatore a una struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER che identifica una descrizione di identificazione.

Valore restituito

nessuno

Osservazioni

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

Se una descrizione di identificazione punta a informazioni aggiuntive archiviate in memoria allocata dinamicamente e se tale memoria viene allocata da una funzione di callback EvtChildListIdentificationDescriptionDuplicate , il driver deve fornire una funzione di callback EvtChildListIdentificationDescriptionCleanup .

In genere, la funzione di callback EvtChildListIdentificationDescriptionDuplicate alloca memoria chiamando ExAllocatePool. La funzione di callback EvtChildListIdentificationDescriptionCleanup deve deallocare tale memoria chiamando ExFreePool. Questa funzione di callback non deve tentare di deallocare il resto della descrizione di identificazione. In altre parole, la funzione di callback non deve deallocare la struttura della descrizione dell'indirizzo a cui punta il parametro IdentificationDescription ; deve deallocare solo allocazioni di memoria aggiuntive a cui punta la struttura della descrizione.

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