IoGetAttachedDevice 函式 (ntifs.h)
IoGetAttachedDevice 例程會傳回與指定裝置相關聯的最高層級裝置物件的指標。
語法
PDEVICE_OBJECT IoGetAttachedDevice(
[in] PDEVICE_OBJECT DeviceObject
);
參數
[in] DeviceObject
要傳回最上層連結裝置之裝置物件的指標。
傳回值
IoGetAttachedDevice 會傳回連結至指定裝置的最高層級裝置。
備註
如果 DeviceObject 指定的裝置對象沒有附加其他裝置物件， 則 DeviceObject 和傳回的指標相等。
IoGetAttachedDevice 在下列方面與 IoGetAttachedDeviceReference 不同：
IoGetAttachedDevice 不會遞增裝置對象的參考計數。 (因此不需要對 ObDereferenceObject 的相符呼叫。)
IoGetAttachedDevice 的呼叫端必須在IoGetAttachedDevice執行時，確保不會在堆疊中新增或移除任何裝置物件。 無法這麼做的呼叫端必須改用 IoGetAttachedDeviceReference 。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |