WdfCollectionGetItem-Funktion (wdfcollection.h)
[Gilt für KMDF und UMDF]
Die WdfCollectionGetItem-Methode gibt ein Handle für das Objekt zurück, das in einer angegebenen Objektauflistung enthalten und einem angegebenen Indexwert zugeordnet ist.
Syntax
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Parameter
[in] Collection
Ein Handle für ein Auflistungsobjekt.
[in] Index
Ein nullbasierter Indexwert, der ein Objekt in der Auflistung identifiziert.
Rückgabewert
WdfCollectionGetItem gibt ein Frameworkobjekthandle oder NULL zurück, wenn der Index-Wert ungültig ist.
Eine Systemfehlerprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Indexwerte stellen die Reihenfolge dar, in der Objekte einer Auflistung hinzugefügt werden. Ein Indexwert von 0 stellt das erste Objekt in der Auflistung, ein Indexwert von 1 das zweite Objekt usw. wie eine verknüpfte Liste dar. Wenn der Treiber Element i aus einer Sammlung entfernt, wird element i+1 zu Element i.
Weitere Informationen zu Objektsammlungen finden Sie unter Framework-Objektsammlungen.
Beispiele
Ein Codebeispiel, das WdfCollectionGetItem verwendet, finden Sie unter WdfCollectionGetCount.
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) |