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.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Os motoristas de ônibus que usam a enumeração de ônibus estático podem chamar WdfFdoLockStaticChildListForIteration.
Depois de chamar WdfFdoLockStaticChildListForIteration, o driver pode chamar repetidamente WdfFdoRetrieveNextStaticChild 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 |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdffdo.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |