WdfObjectDereference-Makro
[Gilt für KMDF und UMDF]
Die WdfObjectDereference Makros erhöht die Referenzanzahl für ein angegebenes Frameworkobjekt.
Syntax
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
Die Parameter
Handle [in]
Ein Handle für ein Frameworkobjekt.
Rückgabewert
Keiner.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Wenn die Referenzanzahl des Objekts null wird, wird das Objekt möglicherweise gelöscht, bevor WdfObjectDereference- zurückgegeben wird.
Ein Treiber kann WdfObjectDereference- nur aufrufen, wenn er zuvor WdfObjectReference-aufgerufen hat.
Anstatt WdfObjectDereference-aufzurufen, kann ein Treiber WdfObjectDereferenceWithTag- oder WdfObjectDereferenceActual-aufrufen.
Weitere Informationen zu Objektverweisanzahlen finden Sie unter Framework Object Life Cycle.
Beispiele
Im folgenden Codebeispiel wird die Referenzanzahl eines Objekts verringert.
WdfObjectDereference(Object);
Anforderungen
Zielplattform |
universelle |
Minimale KMDF-Version |
1.0 |
Minimale UMDF-Version |
2.0 |
Kopfzeile |
Wdfobject.h (enthalten Wdf.h) |
Bibliothek |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
DDI-Complianceregeln |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |