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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour