WdfCollectionGetCount-Funktion (wdfcollection.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfCollectionGetCount--Methode gibt die Anzahl der Objekte zurück, die sich derzeit in einer Objektsammlung befinden.

Syntax

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Parameter

[in] Collection

Ein Handle zu einem Auflistungsobjekt.

Rückgabewert

WdfCollectionGetCount gibt die Anzahl der Objekte zurück, die sich in der Auflistung befinden.

Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Bemerkungen

Weitere Informationen zu Objektsammlungen finden Sie unter Framework-Objektsammlungen.

Beispiele

Das folgende Codebeispiel ruft die Anzahl der Objekte in einer angegebenen Auflistung ab und verwendet die Zahl, um alle Objekte in der Auflistung zu untersuchen.

ULONG count;

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfcollection.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfCollectionGetItem-

Freigeben über