WdfChildListBeginScan, fonction (wdfchildlist.h)
[S’applique à KMDF uniquement]
La méthode WdfChildListBeginScan prépare une liste spécifiée d’appareils enfants afin que le pilote puisse mettre à jour les informations de la liste.
Syntaxe
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Paramètres
[in] ChildList
Handle pour un objet de liste enfant du framework.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
La méthode WdfChildListBeginScan marque tous les appareils enfants de la liste comme manquants.
Après avoir appelé WdfChildListBeginScan, le pilote peut appeler WdfChildListAddOrUpdateChildDescriptionAsPresent à plusieurs reprises, ou appeler WdfChildListUpdateAllChildDescriptionsAsPresent, pour signaler tous les appareils enfants actuellement attachés à l’appareil parent.
Une fois la mise à jour de la liste enfant terminée, le pilote doit appeler WdfChildListEndScan. Cet appel remet la liste enfant mise à jour au gestionnaire Plug-and-Play (PnP). Par la suite, l’infrastructure appelle la fonction de rappel EvtChildListCreateDevice du pilote pour chaque appareil signalé par le pilote.
Pour plus d’informations sur les listes enfants, consultez Énumération dynamique.
Exemples
Pour obtenir un exemple de code qui utilise WdfChildListBeginScan, consultez WdfChildListAddOrUpdateChildDescriptionAsPresent.
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) |