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

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

ObDereferenceObject