WdfObjectDereference-Makro

[Gilt für KMDF und UMDF]

Das WdfObjectDereference-Makro verringert die Verweisanzahl für ein angegebenes Frameworkobjekt.

Syntax

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Handle [in]
Ein Handle für ein Frameworkobjekt.

Keine.

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

Wenn die Verweisanzahl des Objekts null ist, wird das Objekt möglicherweise gelöscht, bevor WdfObjectDereference zurückgibt.

Ein Treiber kann WdfObjectDereference nur aufrufen, wenn er zuvor WdfObjectReference aufgerufen hat.

Anstatt WdfObjectDereference aufzurufen, kann ein Treiber WdfObjectDereferenceWithTag oder WdfObjectDereferenceActual aufrufen.

Weitere Informationen zur Anzahl der Objektverweis finden Sie unter Framework Object Life Cycle.

Im folgenden Codebeispiel wird die Verweisanzahl eines Objekts verringert.

WdfObjectDereference(Object);

Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Header	Wdfobject.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest