Función WdfChildListBeginIteration (wdfchildlist.h)

Artículo
08/08/2023

[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)