WdfObjectDelete-Funktion (wdfobject.h)

[Gilt für KMDF und UMDF]

Die WdfObjectDelete-Methode löscht ein Frameworkobjekt und seine untergeordneten Objekte.

Syntax

void WdfObjectDelete(
  [in] WDFOBJECT Object
);

Parameter

[in] Object

Ein Handle für das Frameworkobjekt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Nachdem ein Treiber WdfObjectDelete aufgerufen hat, wird das angegebene Objekt gelöscht, nachdem seine Verweisanzahl null ist.

Treiber können WdfObjectDelete nicht aufrufen, um die folgenden Frameworkobjekte zu löschen, da das Framework das Löschen dieser Objekte immer verarbeitet:

• Untergeordnete Framework-Listenobjekte (WDFCHILDLIST)
• Framework-Geräteobjekte (WDFDEVICE), es sei denn, der Treiber hat WdfControlDeviceInitAllocate aufgerufen und ein Steuerelementgeräteobjekt erstellt, das der Treiber manchmal löschen muss.
• Frameworktreiberobjekte (WDFDRIVER)
• Frameworkdateiobjekte (WDFFILEOBJECT)
• Framework-Interruptobjekte (WDFINTERRUPT)
• Framework-Warteschlangenobjekte (WDFQUEUE), wenn ein Objekt eine Standard-E/A-Warteschlange darstellt oder wenn der Treiber WdfDeviceConfigureRequestDispatching aufgerufen hat, um die Warteschlange so einzurichten, dass alle E/A-Anforderungen eines bestimmten Typs empfangen werden.
• Framework-USB-Pipe-Objekte (WDFUSBPIPE)
• Framework-USB-Schnittstellenobjekte (WDFUSBINTERFACE)
• Framework-WMI-Anbieterobjekte (WDFWMIPROVIDER)
• Ressourcenbereichslistenobjekt (WDFIORESLIST)
• Ressourcenlistenobjekt (WDFCMRESLIST)
• Ressourcenanforderungslistenobjekt (WDFIORESREQLIST)

Die WdfObjectDelete-Methode kann zurückgeben, bevor das Framework das Objekt und seine untergeordneten Objekte gelöscht hat. Die Reihenfolge, in der das Framework untergeordnete Objekte löscht, ist nicht vorhersagbar.

Weitere Informationen zu WdfObjectDelete und den Bereinigungsregeln für eine Frameworkobjekthierarchie finden Sie unter Framework Object Life Cycle.

Die WdfObjectDelete-Methode muss unter IRQL <= DISPATCH_LEVEL aufgerufen werden. Wenn Ihr Treiber ein Steuerelementgerätobjekt löscht, muss WdfObjectDelete unter IRQL = PASSIVE_LEVEL aufgerufen werden. Wenn Ihr Treiber einen allgemeinen Puffer löscht, muss WdfObjectDelete unter IRQL = PASSIVE_LEVEL aufgerufen werden.

Beispiele

Im folgenden Codebeispiel werden ein Frameworkobjekt und seine untergeordneten Objekte gelöscht.

WdfObjectDelete(Object);

Anforderungen

Weitere Informationen

WdfControlDeviceInitAllocate

WdfObjectCreate