WdfChildListBeginIteration, fonction (wdfchildlist.h)

Article
02/26/2024

[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)