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 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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Versión mínima de KMDF | 1.0 |
Encabezado | wdfchildlist.h (incluya Wdf.h) |
IRQL | <= DISPATCH_LEVEL |
Consulte también
EvtChildListIdentificationDescriptionDuplicate