Función WdfChildListBeginIteration (wdfchildlist.h)
[Solo se aplica a KMDF]
El método WdfChildListBeginIteration prepara el marco para recuperar elementos de una lista secundaria especificada.
Sintaxis
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
Parámetros
[in] ChildList
Identificador de un objeto de lista secundario de marco.
[in] Iterator
Puntero a una estructura de WDF_CHILD_LIST_ITERATOR asignada por el autor de la llamada que indica el tipo de dispositivos secundarios que se van a recuperar.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Después de llamar a WdfChildListBeginIteration, el controlador puede llamar repetidamente a WdfChildListRetrieveNextDevice para obtener información sobre cada dispositivo secundario de la lista secundaria.
Una vez que el controlador haya terminado de llamar a WdfChildListRetrieveNextDevice, debe llamar a WdfChildListEndIteration.
Si el controlador realiza cambios en la lista secundaria después de llamar a WdfChildListBeginIteration, el marco almacena todos los cambios y notifica al administrador de Plug and Play (PnP) los cambios cuando el controlador llama a WdfChildListEndIteration.
El controlador puede anidar llamadas a WdfChildListBeginIteration y WdfChildListEndIteration. Si el controlador anida llamadas a estos métodos, el marco almacena todos los cambios hasta la última llamada a WdfChildListEndIteration.
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 WdfChildListBeginIteration, vea WdfChildListRetrieveNextDevice.
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) |