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
Ninguno
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 Plug and Play (PnP) de los cambios cuando el controlador llama a WdfChildListEndIteration.
El controlador puede anidar llamadas a WdfChildListBeginIteration y WdfChildListEndIteration. Si el controlador anida las 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 use WdfChildListBeginIteration , vea WdfChildListRetrieveNextDevice.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfchildlist.h (incluya Wdf.h) |
| biblioteca de | 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) |