WdfCollectionGetItem, fonction (wdfcollection.h)
[S’applique à KMDF et UMDF]
La méthode WdfCollectionGetItem retourne un handle à l’objet contenu dans une collection d’objets spécifiée et associé à une valeur d’index spécifiée.
Syntaxe
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Paramètres
[in] Collection
Handle d’un objet de collection.
[in] Index
Valeur d’index de base zéro qui identifie un objet dans la collection.
Valeur retournée
WdfCollectionGetItem retourne un handle d’objet framework, ou NULL si la valeur Index n’est pas valide.
Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Les valeurs d’index représentent l’ordre dans lequel les objets sont ajoutés à une collection. Une valeur d’index égale à zéro représente le premier objet de la collection, une valeur d’index de un représente le deuxième objet, et ainsi de suite, comme une liste liée. Lorsque le pilote supprime l’élément i d’une collection, l’élément i+1 devient l’élément i.
Pour plus d’informations sur les collections d’objets, consultez Collections d’objets framework.
Exemples
Pour obtenir un exemple de code qui utilise WdfCollectionGetItem, consultez WdfCollectionGetCount.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfcollection.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |