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

  • Artículo

[Solo se aplica a KMDF]

La función de devolución de llamada de eventos EvtChildListScanForChildren de un controlador debe notificar todos los dispositivos secundarios que están presentes.

Sintaxis

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Parámetros

[in] ChildList

Identificador de un objeto de lista secundario de marco.

Valor devuelto

None

Observaciones

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

Si un controlador proporciona una función de devolución de llamada EvtChildListScanForChildren , el marco lo llama cada vez que el dispositivo primario entra en su estado de trabajo (D0). (Para obtener más información sobre cuándo se llama a esta función de devolución de llamada, consulte Escenarios de administración de energía y PnP).

El controlador debe notificar todos sus dispositivos secundarios haciendo lo siguiente:

  1. Llamar a WdfChildListBeginScan, que marca todos los dispositivos secundarios notificados anteriormente como ausentes.
  2. Detectar dispositivos secundarios y llamar a WdfChildListAddOrUpdateChildDescriptionAsPresent para cada dispositivo detectado.
  3. Llamar a WdfChildListEndScan, que informa al administrador de PnP de los dispositivos secundarios notificados.
Para obtener más información sobre la enumeración dinámica, vea Enumeración de los dispositivos en un bus.

La función de devolución de llamada EvtChildListScanForChildren se llama en IRQL = PASSIVE_LEVEL. No debe hacer que esta función de devolución de llamada se pueda paginar.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfchildlist.h (incluya Wdf.h)
IRQL PASSIVE_LEVEL (consulte la sección Comentarios)

Consulte también

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig