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