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
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Il metodo WdfChildListBeginScan contrassegna tutti i dispositivi figlio nell'elenco come mancanti.
Dopo aver chiamato WdfChildListBeginScan, il driver può chiamare WdfChildListAddOrUpdateChildDescriptionAsPresent ripetutamente oppure chiamare 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à il driver EvtChildListCreateDevice funzione di callback per ogni dispositivo segnalato dal driver.
Per altre informazioni sugli elenchi figlio, vedere 'enumerazione dinamica.
Esempi
Per un esempio di codice che usa WdfChildListBeginScan, vedere WdfChildListAddOrUpdateChildDescriptionAsPresent.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfchildlist.h (include Wdf.h) |
| libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |