Função WdfFdoLockStaticChildListForIteration (wdffdo.h)

  • Artigo

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

Confira também

WdfFdoUnlockStaticChildListFromIteration