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)

Consulte también

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent