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

[in] Collection

Ein Handle für ein Auflistungsobjekt.

[in] Item

Ein Handle für das Frameworkobjekt, das aus der Auflistung entfernt wird.

Keine

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.

Im folgenden Codebeispiel wird ein angegebenes Objekt aus einer angegebenen Objektauflistung entfernt.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

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)