Функция 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) |