Função WdfChildListBeginIteration (wdfchildlist.h)
[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) |