WdfCollectionGetItem, fonction (wdfcollection.h)

  • Article

[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)

Voir aussi

WdfCollectionGetFirstItem

WdfCollectionGetLastItem