IoGetAttachedDeviceReference 函数 (wdm.h)
IoGetAttachedDeviceReference 例程返回指向驱动程序堆栈中最高级别的设备对象的指针,并递增该对象的引用计数。
语法
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
参数
[in] DeviceObject
指向检索最顶层附加设备对象的设备对象的指针。
返回值
IoGetAttachedDeviceReference 在递增对象的引用计数后,返回指向附加设备对象堆栈中最高级别的设备对象的指针。
言论
如果 DeviceObject 上的设备对象 没有附加到它的设备对象,DeviceObject 且返回的指针相等。
设备驱动程序编写器必须确保,当他们完成所有需要执行此调用的作时,它们会调用 ObDereferenceObject,并使用此例程返回的设备对象指针。 如果无法执行此作,将阻止系统由于未完成的引用计数而释放或删除设备对象。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 2000 开始可用。 |
目标平台 | 普遍 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | DanglingDeviceObjectReference(wdm),HwStorPortProhibitedDIS(storport) |