WdfObjectReference-Makro
[Gilt für KMDF und UMDF]
Das WdfObjectReference-Makro erhöht die Verweisanzahl für ein angegebenes Frameworkobjekt.
Syntax
VOID WdfObjectReference(
[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 Ihr Treiber WdfObjectReference aufruft, um eine Verweisanzahl zu erhöhen, muss der Treiber WdfObjectDereference aufrufen, um die Anzahl zu verringern.
Anstatt WdfObjectReference aufzurufen, kann ein Treiber WdfObjectReferenceWithTag oder WdfObjectReferenceActual aufrufen.
Weitere Informationen zur Anzahl der Objektverweis finden Sie unter Framework Object Life Cycle.
Beispiele
Im folgenden Codebeispiel wird die Verweisanzahl eines Objekts erhöht.
WdfObjectReference(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 |