Função WdfChildListBeginIteration (wdfchildlist.h)

Artigo
02/26/2024

[Aplica-se somente ao KMDF]

O método WdfChildListBeginIteration prepara a estrutura para recuperar itens de uma lista filho especificada.

Sintaxe

void WdfChildListBeginIteration(
  [in] WDFCHILDLIST             ChildList,
  [in] PWDF_CHILD_LIST_ITERATOR Iterator
);

Parâmetros

[in] ChildList

Um identificador para um objeto de lista filho da estrutura.

[in] Iterator

Um ponteiro para uma estrutura de WDF_CHILD_LIST_ITERATOR alocada pelo chamador que indica o tipo de dispositivos filho a serem recuperados.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Depois de chamar WdfChildListBeginIteration, o driver pode chamar WdfChildListRetrieveNextDevice repetidamente para obter informações sobre cada dispositivo filho na lista filho.

Depois que o driver terminar de chamar WdfChildListRetrieveNextDevice, ele deverá chamar WdfChildListEndIteration.

Se o driver fizer alterações na lista filho depois de chamar WdfChildListBeginIteration, a estrutura armazenará todas as alterações e notificará o gerenciador de Plug and Play (PnP) das alterações quando o driver chamar WdfChildListEndIteration.

O driver pode aninhar chamadas para WdfChildListBeginIteration e WdfChildListEndIteration. Se o driver aninhar chamadas para esses métodos, a estrutura armazenará todas as alterações até a última chamada para WdfChildListEndIteration.

Para obter mais informações sobre listas filho, consulte Enumeração dinâmica.

Exemplos

Para obter um exemplo de código que usa WdfChildListBeginIteration, consulte WdfChildListRetrieveNextDevice.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfchildlist.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)