WdfCollectionRemove-Funktion (wdfcollection.h)
[Gilt für KMDF und UMDF]
Die WdfCollectionRemove-Methode entfernt ein Objekt aus einer angegebenen Objektauflistung.
Syntax
void WdfCollectionRemove(
[in] WDFCOLLECTION Collection,
[in] WDFOBJECT Item
);
Parameter
[in] Collection
Ein Handle für ein Auflistungsobjekt.
[in] Item
Ein Handle für das Frameworkobjekt, das aus der Auflistung entfernt wird.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Wenn WdfCollectionRemove ein Objekt aus einer Auflistung entfernt, wird die Verweisanzahl des Objekts verringert.
Weitere Informationen zu Objektauflistungen finden Sie unter Framework-Objektauflistungen.
Beispiele
Im folgenden Codebeispiel wird ein angegebenes Objekt aus einer angegebenen Objektauflistung entfernt.
WdfCollectionRemove(
hCollection,
hObject
);
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) |