EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP funzione di callback (wdfchildlist.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

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

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 'enumerazione dinamica, può registrare un EvtChildListIdentificationDescriptionCleanup funzione di callback 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 un EvtChildListIdentificationDescriptionDuplicate funzione di callback, il driver deve fornire un EvtChildListIdentificationDescriptionCleanup funzione di callback.

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 dell'identificazione. In altre parole, la funzione di callback non deve deallocare la struttura di 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 Enumerating the Devices on a Bus.