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

См. также раздел

ObDereferenceObject