EVT_WDF_CHILD_LIST_IDENTIFICATION_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 EvtChildListIdentificationDescriptionCleanup de un controlador libera las asignaciones de memoria para una descripción de identificación asignada a la función de devolución de llamada EvtChildListIdentificationDescriptionDuplicate del controlador.

Sintaxis

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

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

Parámetros

[in] ChildList

Identificador de un objeto de lista secundaria del marco.

[in, out] IdentificationDescription

Puntero a una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que identifica una descripción de identificació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 EvtChildListIdentificationDescriptionCleanup llamando a WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

Si una descripción de identificació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 EvtChildListIdentificationDescriptionDuplicate , el controlador debe proporcionar una función de devolución de llamada EvtChildListIdentificationDescriptionCleanup .

Normalmente, la función de devolución de llamada EvtChildListIdentificationDescriptionDuplicate asigna memoria llamando a ExAllocatePool. La función de devolución de llamada EvtChildListIdentificationDescriptionCleanup 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 identificació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 IdentificationDescription ; 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.