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.
Retornar valor
Nenhum
Comentários
Um bug marcar ocorrerá se o driver fornecer 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 entrega a lista filho atualizada para o gerenciador de 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 |
|---|---|
| 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 da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |