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.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Depois de chamar WdfChildListBeginIteration, o driver pode chamar repetidamente WdfChildListRetrieveNextDevice 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 a 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

Consulte também

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_ITERATOR

WDF_CHILD_LIST_ITERATOR_INIT

WdfChildListBeginScan

WdfChildListEndIteration

WdfChildListRequestChildEject

WdfChildListRetrieveNextDevice