Funzione WdfChildListBeginIteration (wdfchildlist.h)
[Si applica solo a KMDF]
Il metodo WdfChildListBeginIteration prepara il framework per il recupero di elementi da un elenco figlio specificato.
Sintassi
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
Parametri
[in] ChildList
Handle per un oggetto elenco figlio del framework.
[in] Iterator
Puntatore a una struttura di WDF_CHILD_LIST_ITERATOR allocata dal chiamante che indica il tipo di dispositivi figlio da recuperare.
Valore restituito
Nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Dopo aver chiamato WdfChildListBeginIteration, il driver può chiamare ripetutamente WdfChildListRetrieveNextDevice per ottenere informazioni su ogni dispositivo figlio nell'elenco figlio.
Al termine della chiamata del driver WdfChildListRetrieveNextDevice, deve chiamare WdfChildListEndIteration.
Se il driver apporta modifiche all'elenco figlio dopo aver chiamato WdfChildListBeginIteration, il framework archivia tutte le modifiche e notifica al gestore Plug and Play (PnP) delle modifiche quando il driver chiama WdfChildListEndIteration.
Il driver può annidare le chiamate a WdfChildListBeginIteration e WdfChildListEndIteration. Se il driver annida le chiamate a questi metodi, il framework archivia tutte le modifiche fino all'ultima chiamata a WdfChildListEndIteration.
Per altre informazioni sugli elenchi figlio, vedere 'enumerazione dinamica.
Esempi
Per un esempio di codice che usa WdfChildListBeginIteration, vedere WdfChildListRetrieveNextDevice.
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) |