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 WDF_CHILD_LIST_ITERATOR allocata dal chiamante che indica il tipo di dispositivi figlio da recuperare.
Valore restituito
nessuno
Osservazioni
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Dopo aver chiamato WdfChildListBeginIteration, il driver può chiamare ripetutamente WdfChildListRetrieveNextDevice per ottenere informazioni su ogni dispositivo figlio nell'elenco figlio.
Al termine della chiamata al 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 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.
Esempio
Per un esempio di codice che usa WdfChildListBeginIteration, vedere WdfChildListRetrieveNextDevice.
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) |