Freigeben über


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

Siehe auch

WdfObjectReferenceActual-

WdfObjectReferenceWithTag-