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