WdfCollectionGetCount, fonction (wdfcollection.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

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

Syntaxe

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Paramètres

[in] Collection

Handle d’un objet de collection.

Valeur de retour

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

Une vérification des bogues système se produit si le pilote fournit un handle d’objet non valide.

Remarques

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

Exemples

L’exemple de code suivant obtient le nombre d’objets d’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.
    // 
}

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)

Voir aussi

WdfCollectionGetItem

Partager via