共用方式為


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

另請參閱

IoGetAttachedDeviceReference

ObDereferenceObject