WdfCollectionRemoveItem-Funktion (wdfcollection.h)

[Gilt für KMDF und UMDF]

Die WdfCollectionRemoveItem-Methode entfernt ein angegebenes Objekt basierend auf einem angegebenen Indexwert aus einer Objektauflistung.

Syntax

void WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parameter

[in] Collection

Ein Handle für ein Auflistungsobjekt.

[in] Index

Ein nullbasierter Index, der das zu entfernende Objekt identifiziert.

Rückgabewert

Keine

Bemerkungen

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

Indexwerte stellen die Reihenfolge dar, in der Objekte einer Auflistung hinzugefügt werden. Ein Indexwert von 0 stellt das erste Objekt dar, das der Auflistung hinzugefügt wurde, ein Indexwert von 1 das zweite Objekt usw.

Wenn WdfCollectionRemoveItem ein Objekt aus einer Auflistung entfernt, wird die Verweisanzahl des Objekts verringert.

Weitere Informationen zu Objektsammlungen finden Sie unter Framework-Objektsammlungen.

Beispiele

Ein Codebeispiel, das WdfCollectionRemoveItem verwendet, finden Sie unter WdfCollectionGetFirstItem.

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

WdfCollectionRemove