共用方式為


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)

另請參閱

ObDereferenceObject