WdfChildListBeginIteration, fonction (wdfchildlist.h)
[S’applique à KMDF uniquement]
La méthode WdfChildListBeginIteration prépare l’infrastructure pour la récupération d’éléments à partir d’une liste enfant spécifiée.
Syntaxe
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
Paramètres
[in] ChildList
Handle pour un objet de liste enfant du framework.
[in] Iterator
Pointeur vers une structure de WDF_CHILD_LIST_ITERATOR allouée par l’appelant qui indique le type d’appareils enfants à récupérer.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Après avoir appelé WdfChildListBeginIteration, le pilote peut appeler À plusieurs reprises WdfChildListRetrieveNextDevice pour obtenir des informations sur chaque appareil enfant dans la liste enfant.
Une fois que le pilote a terminé d’appeler WdfChildListRetrieveNextDevice, il doit appeler WdfChildListEndIteration.
Si le pilote apporte des modifications à la liste enfant après avoir appelé WdfChildListBeginIteration, le framework stocke toutes les modifications et notifie le gestionnaire Plug-and-Play (PnP) des modifications lorsque le pilote appelle WdfChildListEndIteration.
Le pilote peut imbriquer des appels à WdfChildListBeginIteration et WdfChildListEndIteration. Si le pilote imbriquez les appels à ces méthodes, le framework stocke toutes les modifications jusqu’au dernier appel à WdfChildListEndIteration.
Pour plus d’informations sur les listes enfants, consultez Énumération dynamique.
Exemples
Pour obtenir un exemple de code qui utilise WdfChildListBeginIteration, consultez WdfChildListRetrieveNextDevice.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfchildlist.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |