Функция IoGetAttachedDeviceReference (wdm.h)

Подпрограмма IoGetAttachedDeviceReference возвращает указатель на объект устройства верхнего уровня в стеке драйверов и увеличивает количество ссылок для этого объекта.

Синтаксис

PDEVICE_OBJECT IoGetAttachedDeviceReference(
  [in] PDEVICE_OBJECT DeviceObject
);

Параметры

[in] DeviceObject

Указатель на объект устройства, для которого извлекается самый верхний подключенный объект устройства.

Возвращаемое значение

IoGetAttachedDeviceReference возвращает указатель на объект устройства самого высокого уровня в стеке присоединенных объектов устройства после увеличения количества ссылок для объекта.

Замечания

Если объект устройства DeviceObject не подключен к нему, DeviceObject и возвращаемый указатель равны.

Средства записи драйверов устройств должны убедиться, что при выполнении всех операций, необходимых для выполнения этого вызова, они вызывают ObDereferenceObject с указателем объекта устройства, возвращенным этой подпрограммой. Сбой этого не позволит системе освободить или удалить объект устройства из-за выдающегося количества ссылок.

Требования

См. также

ObDereferenceObject