WdfObjectReference-makro

[Gäller för KMDF och UMDF]

WdfObjectReference makro ökar referensantalet för ett angivet ramverksobjekt.

Syntax

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Parameterar

Hantera [in]
Ett handtag till ett ramverksobjekt.

Returvärde

Ingen.

En felkontroll inträffar om drivrutinen tillhandahåller ett ogiltigt objekthandtag.

Anmärkningar

Om drivrutinen anropar WdfObjectReference för att öka antalet referenser måste drivrutinen anropa WdfObjectDereference för att minska antalet.

I stället för att anropa WdfObjectReferencekan en drivrutin anropa WdfObjectReferenceWithTag eller WdfObjectReferenceActual.

Mer information om antalet objektreferenser finns i Framework Object Life Cycle.

Exempel

I följande kodexempel ökar ett objekts referensantal.

WdfObjectReference(Object); 

Krav

Målplattform	Universell
Lägsta KMDF-version	1.0
Lägsta UMDF-version	2.0
Header	Wdfobject.h (inkludera Wdf.h)
Bibliotek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_NIVÅ
DDI-efterlevnadsregler	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

Se även

WdfObjectReferenceActual

WdfObjectReferenceWithTag