WdfChildListBeginIteration, fonction (wdfchildlist.h)
[S’applique uniquement à KMDF]
La méthode WdfChildListBeginIteration prépare l’infrastructure pour récupérer des é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 d’un objet de liste enfant framework.
[in] Iterator
Pointeur vers une structure WDF_CHILD_LIST_ITERATOR allouée par l’appelant qui indique le type d’appareils enfants à récupérer.
Valeur de retour
Aucun
Remarques
Une vérification de bogue 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 de la liste enfant.
Une fois le pilote terminé d’appeler WdfChildListRetrieveNextDevice, il doit appeler WdfChildListEndIteration.
Si le pilote apporte des modifications à la liste enfant après avoir appelé WdfChildListBeginIteration, l’infrastructure stocke toutes les modifications et avertit 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 imbrication des appels à ces méthodes, l’infrastructure stocke toutes les modifications jusqu’à ce que le dernier appel à WdfChildListEndIteration.
Pour plus d’informations sur les listes enfants, consultez d’énumération dynamique .
Exemples
Pour obtenir un exemple de code qui utilise WdfChildListBeginIteration, consultez WdfChildListRetrieveNextDevice.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfchildlist.h (include Wdf.h) |
| bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |