Função WdfChildListBeginScan (wdfchildlist.h)
[Aplica-se somente ao KMDF]
O método WdfChildListBeginScan prepara uma lista especificada de dispositivos filho para que o driver possa atualizar as informações na lista.
Sintaxe
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Parâmetros
[in] ChildList
Um identificador para um objeto de lista filho da estrutura.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
O método WdfChildListBeginScan marca todos os dispositivos filho na lista como ausentes.
Depois de chamar WdfChildListBeginScan, o driver pode chamar WdfChildListAddOrUpdateChildDescriptionAsPresent repetidamente ou chamar WdfChildListUpdateAllChildDescriptionsAsPresent, para relatar todos os dispositivos filho que estão atualmente anexados ao dispositivo pai.
Depois que o driver terminar de atualizar a lista filho, ele deverá chamar WdfChildListEndScan. Essa chamada fornece a lista filho atualizada para o gerenciador do Plug and Play (PnP). Posteriormente, a estrutura chamará a função de retorno de chamada EvtChildListCreateDevice do driver para cada dispositivo relatado pelo driver.
Para obter mais informações sobre listas filho, consulte Enumeração Dinâmica.
Exemplos
Para obter um exemplo de código que usa WdfChildListBeginScan, consulte WdfChildListAddOrUpdateChildDescriptionAsPresent.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfchildlist.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) |