WdfCollectionGetItem-Funktion (wdfcollection.h)

  • Artikel

[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)

Weitere Informationen

WdfCollectionGetFirstItem

WdfCollectionGetLastItem