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.h （包括 Wdf.h） |
圖書館 |
Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF） |
IRQL |
<= DISPATCH_LEVEL |
DDI 合規性規則 |
DriverCreate、MemAfterReqCompletedIntIoctlA、MemAfterReqCompletedIoctlA、MemAfterReqCompletedReadA、MemAfterReqCompletedWriteA |