WdfObjectReference マクロ

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

構文

VOID WdfObjectReference(
  [in]  WDFOBJECT Handle
);

パラメーター

  • Handle [in]
    A handle to a framework object.

戻り値

None.

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

解説

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.

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

  WdfObjectReference(Object); 

要件

バージョン

Available in version 1.0 and later versions of KMDF.

ヘッダー

Wdfobject.h (includeWdf.h)

ライブラリ

Wdf<MajorVersionNumber>000.sys (see Framework Library Versions.)

IRQL

<=DISPATCH_LEVEL

参照

WdfObjectReferenceActual

WdfObjectReferenceWithTag