WdfObjectReference 宏
[適用于 KMDF 和 UMDF]
WdfObjectReference宏會遞增指定 framework 物件的參考計數。
語法
VOID WdfObjectReference(
[in] WDFOBJECT Handle
);
參數
控制碼 [in]
架構物件的控制碼。
傳回值
無。
如果驅動程式提供不正確物件控制碼，就會發生錯誤檢查。
備註
如果您的驅動程式呼叫 WdfObjectReference 來遞增參考計數，驅動程式必須呼叫 WdfObjectDereference 以遞減計數。
驅動程式可呼叫WdfObjectReferenceWithTag或WdfObjectReferenceActual，而不是呼叫WdfObjectReference。
如需物件參考計數的詳細資訊，請參閱 Framework 物件生命週期。
範例
下列程式碼範例會遞增物件的參考計數。
WdfObjectReference(Object);
規格需求
目標平台 |
通用 |
最小 KMDF 版本 |
1.0 |
最小的 UMDF 版本 |
2.0 |
標頭 |
Wdfobject (包含 Wdf. h) |
程式庫 |
Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
DDI 合規性規則 |
DriverCreate、 MemAfterReqCompletedIntIoctlA、 MemAfterReqCompletedIoctlA、 MemAfterReqCompletedReadA、 MemAfterReqCompletedWriteA |