IWDFObject::D eleteWdfObject-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die DeleteWdfObject-Methode löscht ein zuvor erstelltes WDF-Objekt (Microsoft Windows Driver Frameworks).

Syntax

HRESULT DeleteWdfObject();

Rückgabewert

DeleteWdfObject gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) oder einen der anderen Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Ein Treiber kann einige WDF-Objekte nicht löschen. Beispielsweise kann der Treiber ein Framework-Geräteobjekt nicht löschen, da das Framework Geräteobjekte besitzt und steuert. Weitere Informationen zur Hierarchie von WDF-Objekten finden Sie unter Framework-Objekthierarchie.

Der Treiber löscht in der Regel nur WDF-Objekte, die er erstellt und besitzt. Weitere Informationen zum Löschen von Frameworkobjekten finden Sie unter Verwalten der Lebensdauer von Objekten.

Wenn jedoch ein übergeordnetes Objekt gelöscht wird, werden alle untergeordneten Objekte automatisch gelöscht. Wenn beispielsweise der Treiber mit dem Namen IWDFDevice::CreateIoQueue ein E/A-Warteschlangenobjekt erstellen soll, wird die neu erstellte E/A-Warteschlange zu einem untergeordneten Element des Geräteobjekts. Das E/A-Warteschlangenobjekt wird dann automatisch gelöscht, wenn das Geräteobjekt gelöscht wird, ohne dass der Treiber DeleteWdfObject explizit aufruft.

Beispiele

Ein Codebeispiel für die Verwendung der DeleteWdfObject-Methode finden Sie unter IWDFDevice::SetPnpState.

Anforderungen

Weitere Informationen

IWDFDevice::CreateIoQueue

IWDFObject