WdfCollectionGetCount, fonction (wdfcollection.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfCollectionGetCount retourne le nombre d’objets qui se trouvent actuellement dans une collection d’objets.

Syntaxe

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Paramètres

[in] Collection

Handle d’un objet de collection.

Valeur retournée

WdfCollectionGetCount retourne le nombre d’objets qui se trouvent dans la collection.

Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les collections d’objets, consultez Collections d’objets framework.

Exemples

L’exemple de code suivant obtient le nombre d’objets dans une collection spécifiée et utilise le nombre pour examiner tous les objets de la collection.

ULONG count;

count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
    ObjectHandle = WdfCollectionGetItem(
                                        CollectionHandle,
                                        i
                                        );
    // 
    // Perform object-specific operations.
    // 
}

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

WdfCollectionGetItem