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
);
Parameter
Handle [in]
Ein Handle für ein Frameworkobjekt.
Rückgabewert
Keine.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
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.
Beispiele
Im folgenden Codebeispiel wird die Verweisanzahl eines Objekts verringert.
WdfObjectDereference(Object);
Anforderungen
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 |