WdfCollectionGetCount-Funktion (wdfcollection.h)
[Gilt für KMDF und UMDF]
Die WdfCollectionGetCount-Methode gibt die Anzahl der Objekte zurück, die sich derzeit in einer Objektauflistung befinden.
Syntax
ULONG WdfCollectionGetCount(
[in] WDFCOLLECTION Collection
);
Parameter
[in] Collection
Ein Handle für ein 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.
Hinweise
Weitere Informationen zu Objektauflistungen finden Sie unter Framework-Objektauflistungen.
Beispiele
Im folgenden Codebeispiel wird die Anzahl der Objekte in einer angegebenen Auflistung abgerufen und die Zahl verwendet, 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 | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfcollection.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |