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
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |