Funzione WdfChildListBeginScan (wdfchildlist.h)
[Si applica solo a KMDF]
Il metodo WdfChildListBeginScan prepara un elenco specificato di dispositivi figlio in modo che il driver possa aggiornare le informazioni nell'elenco.
Sintassi
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Parametri
[in] ChildList
Handle per un oggetto elenco figlio del framework.
Valore restituito
nessuno
Osservazioni
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Il metodo WdfChildListBeginScan contrassegna tutti i dispositivi figlio nell'elenco come mancante.
Dopo aver chiamato WdfChildListBeginScan, il driver può chiamare WdfChildListAddOrUpdateChildDescriptionAsPresent ripetutamente oppure chiamare ripetutamente WdfChildListUpdateAllChildDescriptionsAsPresent per segnalare tutti i dispositivi figlio attualmente collegati al dispositivo padre.
Al termine dell'aggiornamento dell'elenco figlio, il driver deve chiamare WdfChildListEndScan. Questa chiamata recapita l'elenco figlio aggiornato al gestore Plug and Play (PnP). Successivamente, il framework chiamerà la funzione di callback EvtChildListCreateDevice per ogni dispositivo segnalato dal driver.
Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.
Esempio
Per un esempio di codice che usa WdfChildListBeginScan, vedere WdfChildListAddOrUpdateChildDescriptionAsPresent.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfchildlist.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |