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

[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 que la función de devolución de llamada EvtChildListIdentificationDescriptionDuplicate función de devolución de llamada.

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

Ninguno

Observaciones

Si un controlador de bus usa enumeración dinámica, puede registrar un EvtChildListIdentificationDescriptionCleanup función de devolución de llamada 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 se asigna mediante 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.

Requisitos

Consulte también

EvtChildListIdentificationDescriptionDuplicate

ExAllocatePool

ExFreePool

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfChildListCreate

WdfFdoInitSetDefaultChildListConfig