Функция IoGetAttachedDeviceReference (wdm.h)
Подпрограмма IoGetAttachedDeviceReference возвращает указатель на объект устройства верхнего уровня в стеке драйверов и увеличивает количество ссылок для этого объекта.
Синтаксис
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
Параметры
[in] DeviceObject
Указатель на объект устройства, для которого извлекается самый верхний подключенный объект устройства.
Возвращаемое значение
IoGetAttachedDeviceReference возвращает указатель на объект устройства самого высокого уровня в стеке присоединенных объектов устройства после увеличения количества ссылок для объекта.
Замечания
Если объект устройства DeviceObject не подключен к нему, DeviceObject и возвращаемый указатель равны.
Средства записи драйверов устройств должны убедиться, что при выполнении всех операций, необходимых для выполнения этого вызова, они вызывают ObDereferenceObject с указателем объекта устройства, возвращенным этой подпрограммой. Сбой этого не позволит системе освободить или удалить объект устройства из-за выдающегося количества ссылок.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDIs(storport) |