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）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DanglingDeviceObjectReference (wdm) ， HwStorPortProhibitedDDI (storport)

另请参阅

ObDereferenceObject