WdfCollectionRemoveItem-Funktion (wdfcollection.h)
[Gilt für KMDF und UMDF]
Die WdfCollectionRemoveItem- Methode entfernt ein angegebenes Objekt aus einer Objektauflistung, basierend auf einem angegebenen Indexwert.
Syntax
void WdfCollectionRemoveItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Parameter
[in] Collection
Ein Handle zu einem Auflistungsobjekt.
[in] Index
Ein nullbasierter Index, der das zu entfernende Objekt identifiziert.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Indexwerte stellen die Reihenfolge dar, in der Objekte einer Auflistung hinzugefügt werden. Ein Indexwert von Null 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 Referenzanzahl 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- | 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) |