WdfObjectReference 宏

[適用於 KMDF 和 UMDF]

WdfObjectReference 宏會遞增指定架構對象的參考計數。

語法

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

參數

句柄 [in]
架構物件的句柄。

傳回值

無。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

如果您的驅動程式呼叫 WdfObjectReference 以遞增參考計數，驅動程式必須呼叫 WdfObjectDereference 來遞減計數。

驅動程式可以呼叫 WdfObjectReferenceWithTag 或 WdfObjectReferenceActual，而不是呼叫 WdfObjectReference。

如需對象參考計數的詳細資訊，請參閱 Framework 物件生命週期。

範例

下列程式代碼範例會遞增對象的參考計數。

WdfObjectReference(Object); 

規格需求

目標平台	Universal
最小 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	Wdfobject.h (包含 Wdf.h)
媒體櫃	Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	DriverCreate、 MemAfterReqCompletedIntIoctlA、 MemAfterReqCompletedIoctlA、 MemAfterReqCompletedReadA、 MemAfterReqCompletedWriteA

另請參閱

WdfObjectReferenceActual

WdfObjectReferenceWithTag