Función WdfFdoLockStaticChildListForIteration (wdffdo.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfFdoLockStaticChildListForIteration prepara el marco para recuperar elementos de la lista secundaria estática que pertenece a un dispositivo primario especificado.

Sintaxis

void WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

Parámetros

[in] Fdo

Identificador de un objeto de dispositivo de marco que representa el dispositivo primario.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Los controladores de bus que usan la enumeración de bus estática pueden llamar a WdfFdoLockStaticChildListForIteration.

Después de llamar a WdfFdoLockStaticChildListForIteration, el controlador puede llamar repetidamente a WdfFdoRetrieveNextStaticChild para obtener información sobre cada dispositivo secundario de la lista secundaria.

Una vez que el controlador haya terminado de llamar a WdfFdoRetrieveNextStaticChild, debe llamar a WdfFdoUnlockStaticChildListFromIteration.

Si el controlador realiza cambios en la lista secundaria después de llamar a WdfFdoLockStaticChildListForIteration, el marco almacena todos los cambios y notifica al administrador de Plug and Play (PnP) de los cambios cuando el controlador llama a WdfFdoUnlockStaticChildListFromIteration.

El controlador puede anidar llamadas a WdfFdoLockStaticChildListForIteration y WdfFdoUnlockStaticChildListFromIteration. Si el controlador anida llamadas a estos métodos, el marco almacena todos los cambios hasta la última llamada a WdfFdoUnlockStaticChildListFromIteration.

Para obtener más información sobre las listas secundarias estáticas, vea Static Enumeration( Enumeración estática).

Ejemplos

Para obtener un ejemplo de código que usa WdfFdoLockStaticChildListForIteration, vea WdfFdoRetrieveNextStaticChild.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdffdo.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

WdfFdoUnlockStaticChildListFromIteration