WdfCollectionGetCount, fonction (wdfcollection.h)

Article
02/26/2024

[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

Partager via