Freigeben über


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