IoGetAttachedDeviceReference 函式 (ntifs.h)
IoGetAttachedDeviceReference 例程會傳回驅動程式堆棧中最高層級裝置物件的指標,並遞增該對象的參考計數。
語法
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
參數
[in] DeviceObject
擷取最上層連結裝置對象的裝置物件的指標。
傳回值
IoGetAttachedDeviceReference 在遞增對象的參考計數之後,傳回附加裝置物件堆棧中最高層級裝置物件的指標。
言論
如果 deviceObject 的裝置對象沒有連結至它的裝置物件,DeviceObject 且傳回的指標相等。
設備驅動器寫入器必須確定,當他們完成完成要求進行此呼叫的所有作業時,它們會呼叫 ObDereferenceObject 此例程所傳回的裝置物件指標。 若無法這麼做,系統將無法釋放或刪除裝置對象,因為未處理的參考計數。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
目標平臺 | 普遍 |
標頭 | ntifs.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | DanglingDeviceObjectReference(wdm),HwStorPortProhibitedDIs(storport) |