Função WdfFdoLockStaticChildListForIteration (wdffdo.h)
[Aplica-se somente ao KMDF]
O método WdfFdoLockStaticChildListForIteration prepara a estrutura para recuperar itens da lista filho estática que pertence a um dispositivo pai especificado.
Sintaxe
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
Parâmetros
[in] Fdo
Um identificador para um objeto de dispositivo de estrutura que representa o dispositivo pai.
Retornar valor
Nenhum
Comentários
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Os drivers de barramento que usam enumeração de barramento estático podem chamar WdfFdoLockStaticChildListForIteration.
Depois de chamar WdfFdoLockStaticChildListForIteration, o driver pode chamar WdfFdoRetrieveNextStaticChild repetidamente para obter informações sobre cada dispositivo filho na lista filho.
Depois que o driver terminar de chamar WdfFdoRetrieveNextStaticChild, ele deverá chamar WdfFdoUnlockStaticChildListFromIteration.
Se o driver fizer alterações na lista filho depois de chamar WdfFdoLockStaticChildListForIteration, a estrutura armazenará todas as alterações e notificará o gerenciador de Plug and Play (PnP) das alterações quando o driver chamar WdfFdoUnlockStaticChildListFromIteration.
O driver pode aninhar chamadas para WdfFdoLockStaticChildListForIteration e WdfFdoUnlockStaticChildListFromIteration. Se o driver aninhar chamadas para esses métodos, a estrutura armazenará todas as alterações até a última chamada para WdfFdoUnlockStaticChildListFromIteration.
Para obter mais informações sobre listas filho estáticas, consulte Enumeração estática.
Exemplos
Para obter um exemplo de código que usa WdfFdoLockStaticChildListForIteration, consulte WdfFdoRetrieveNextStaticChild.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdffdo.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |