WdfObjectReference-Makro
[Gilt für KMDF und UMDF]
Das WdfObjectReference Makros erhöht die Verweisanzahl für ein angegebenes Frameworkobjekt.
Syntax
VOID WdfObjectReference(
[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 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 zu Objektverweisanzahlen finden Sie unter Framework Object Life Cycle.
Beispiele
Im folgenden Codebeispiel wird die Referenzanzahl eines Objekts erhöht.
WdfObjectReference(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 |