WdfObjectDereference 宏
[適用於 KMDF 和 UMDF]
WdfObjectDereference 宏會遞減指定架構對象的參考計數。
語法
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
參數
處理 [in]
架構物件的句柄。
傳回值
無。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如果對象的參考計數變成零，在 WdfObjectDereference 傳回之前，可能會刪除物件。
只有在先前呼叫 WdfObjectReference 時，驅動程式才能呼叫 WdfObjectDereference。
驅動程式可以呼叫 WdfObjectDereferenceWithTag 或 WdfObjectDereferenceActual，而不是呼叫 WdfObjectDereference。
如需對象參考計數的詳細資訊，請參閱 Framework 物件生命週期。
範例
下列程式代碼範例會遞減對象的參考計數。
WdfObjectDereference(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、 wdfioqueuefindrequestfailed、 wdfioqueueretrievefoundrequest |