IoGetAttachedDeviceReference 函式 (wdm.h)

  • 發行項

IoGetAttachedDeviceReference 例程會傳回驅動程式堆疊中最高層級裝置物件的指標，並遞增該對象的參考計數。

語法

PDEVICE_OBJECT IoGetAttachedDeviceReference(
  [in] PDEVICE_OBJECT DeviceObject
);

參數

[in] DeviceObject

擷取最上層連接裝置對象的裝置物件的指標。

傳回值

IoGetAttachedDeviceReference 會在遞增對象的參考計數之後，傳回附加裝置物件堆疊中最高層級裝置物件的指標。

備註

如果 DeviceObject 上的裝置對象沒有與其連結的裝置物件， DeviceObject 和傳回的指標相等。

設備驅動器寫入器必須確定當它們完成所有需要進行此呼叫的作業時，它們會以此例程所傳回的裝置對象指標呼叫 ObDereferenceObject 。 若無法這麼做，系統將無法釋放或刪除裝置對象，因為未處理的參考計數。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DanglingDeviceObjectReference (wdm) 、 HwStorPortProhibitedDDIs (storport)

另請參閱

ObDereferenceObject