Fonction WdfCollectionGetItem (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 de retour
WdfCollectionGetItem retourne un handle d’objet framework, ou NULL si la valeur Index n’est pas valide.
Une vérification des bogues système 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 de zéro représente le premier objet de la collection, une valeur d’index d’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 Framework Object Collections.
Exemples
Pour obtenir un exemple de code qui utilise WdfCollectionGetItem, consultez WdfCollectionGetCount.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfcollection.h (include 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) |