Función WdfChildListBeginScan (wdfchildlist.h)
[Solo se aplica a KMDF]
El método WdfChildListBeginScan prepara una lista especificada de dispositivos secundarios para que el controlador pueda actualizar la información de la lista.
Sintaxis
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Parámetros
[in] ChildList
Identificador de un objeto de lista secundario de marco.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
El método WdfChildListBeginScan marca todos los dispositivos secundarios de la lista como ausentes.
Después de llamar a WdfChildListBeginScan, el controlador puede llamar a WdfChildListAddOrUpdateChildDescriptionAsPresent repetidamente, o llamar a WdfChildListUpdateAllChildDescriptionsAsPresent, para notificar todos los dispositivos secundarios que están conectados actualmente al dispositivo primario.
Una vez que el controlador haya terminado de actualizar la lista secundaria, debe llamar a WdfChildListEndScan. Esta llamada entrega la lista secundaria actualizada al administrador de Plug and Play (PnP). Posteriormente, el marco llamará a la función de devolución de llamada EvtChildListCreateDevice del controlador para cada dispositivo que notificó el controlador.
Para obtener más información sobre las listas secundarias, vea Enumeración dinámica.
Ejemplos
Para obtener un ejemplo de código que usa WdfChildListBeginScan, vea WdfChildListAddOrUpdateChildDescriptionAsPresent.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfchildlist.h (incluya Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |