WdfCollectionRemove-Funktion (wdfcollection.h)

  • Artikel

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

Weitere Informationen

WdfCollectionRemoveItem