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

Weitere Informationen

WdfObjectReferenceActual

WdfObjectReferenceWithTag