Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
La méthode WdfFdoLockStaticChildListForIteration prépare l’infrastructure pour récupérer des éléments de la liste enfant statique qui appartient à un appareil parent spécifié.
Syntaxe
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
Paramètres
[in] Fdo
Handle vers un objet d’appareil framework qui représente l’appareil parent.
Valeur de retour
Aucun
Remarques
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Les pilotes de bus qui utilisent l’énumération de bus statique peuvent appeler WdfFdoLockStaticChildListForIteration.
Après avoir appelé WdfFdoLockStaticChildListForIteration, le pilote peut appeler à plusieurs reprises WdfFdoRetrieveNextStaticChild pour obtenir des informations sur chaque appareil enfant de la liste enfant.
Une fois le pilote terminé d’appeler WdfFdoRetrieveNextStaticChild, il doit appeler WdfFdoUnlockStaticChildListFromIteration.
Si le pilote apporte des modifications à la liste enfant après avoir appelé WdfFdoLockStaticChildListForIteration, l’infrastructure stocke toutes les modifications et avertit le gestionnaire Plug-and-Play (PnP) des modifications lorsque le pilote appelle WdfFdoUnlockStaticChildListFromIteration.
Le pilote peut imbriquer des appels à WdfFdoLockStaticChildListForIteration et WdfFdoUnlockStaticChildListFromIteration. Si le pilote imbrique les appels à ces méthodes, l’infrastructure stocke toutes les modifications jusqu’à ce que le dernier appel à WdfFdoUnlockStaticChildListFromIteration.
Pour plus d’informations sur les listes enfants statiques, consultez énumération statique.
Exemples
Pour obtenir un exemple de code qui utilise WdfFdoLockStaticChildListForIteration, consultez WdfFdoRetrieveNextStaticChild.
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| En-tête | wdffdo.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) |