EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP función de devolución de llamada (wdfchildlist.h)

Artículo
08/08/2023

[Solo se aplica a KMDF]

La función de devolución de llamada de eventos EvtChildListAddressDescriptionCleanup de un controlador libera las asignaciones de memoria para una descripción de dirección asignada a la función de devolución de llamada EvtChildListAddressDescriptionDuplicate del controlador.

Sintaxis

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

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

Parámetros

[in] ChildList

Identificador de un objeto de lista secundaria del marco.

[in, out] AddressDescription

Puntero a una estructura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER que identifica una descripción de dirección.

Valor devuelto

None

Observaciones

Si un controlador de bus usa una enumeración dinámica, puede registrar una función de devolución de llamada EvtChildListAddressDescriptionCleanup llamando a WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

Si una descripción de la dirección apunta a información adicional almacenada en memoria asignada dinámicamente y si esa memoria está asignada por una función de devolución de llamada EvtChildListAddressDescriptionDuplicate , el controlador debe proporcionar una función de devolución de llamada EvtChildListAddressDescriptionCleanup .

Normalmente, la función de devolución de llamada EvtChildListAddressDescriptionDuplicate asigna memoria llamando a ExAllocatePool. La función de devolución de llamada EvtChildListAddressDescriptionCleanup debe desasignar esa memoria llamando a ExFreePool. Esta función de devolución de llamada no debe intentar desasignar el resto de la descripción de la dirección. Es decir, la función de devolución de llamada no debe desasignar la estructura de descripción de dirección a la que apunta el parámetro AddressDescription ; debe desasignar solo asignaciones de memoria adicionales a las que apunta la estructura de descripción.

Para obtener más información sobre la enumeración dinámica, vea Enumerar los dispositivos en un bus.