IoGetAttachedDevice 函式 (ntifs.h)
IoGetAttachedDevice 例程會傳回與指定裝置相關聯的最高層級裝置物件的指標。
語法
PDEVICE_OBJECT IoGetAttachedDevice(
[in] PDEVICE_OBJECT DeviceObject
);
參數
[in] DeviceObject
要傳回最上層連結裝置之裝置物件的指標。
傳回值
IoGetAttachedDevice 會傳回連結至指定裝置的最高層級裝置。
言論
如果 DeviceObject 所指定的裝置物件 沒有附加其他裝置物件,DeviceObject 且傳回的指標相等。
IoGetAttachedDevice 與下列方面 IoGetAttachedDeviceReference 不同:
IoGetAttachedDevice 不會遞增裝置對象的參考計數。 (因此,不需要 ObDereferenceObject 的相符呼叫。
IoGetAttachedDevice 的呼叫者 必須確保在執行 IoGetAttachedDevice 時,不會將任何裝置物件新增至堆疊或從堆疊中移除。 無法執行這項作的呼叫端必須改用 IoGetAttachedDeviceReference。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |