WdfObjectReference macro

[Applies to KMDF and UMDF]

The WdfObjectReference macro increments the reference count for a specified framework object.

Syntax

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Parameters

Handle [in]
A handle to a framework object.

Return value

None.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

If your driver calls WdfObjectReference to increment a reference count, the driver must call WdfObjectDereference to decrement the count.

Instead of calling WdfObjectReference, a driver can call WdfObjectReferenceWithTag or WdfObjectReferenceActual.

For more information about object reference counts, see Framework Object Life Cycle.

Examples

The following code example increments an object's reference count.

WdfObjectReference(Object); 

Requirements

Target platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	Wdfobject.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

See also

WdfObjectReferenceActual

WdfObjectReferenceWithTag