структура DEVICE_OBJECT (wdm.h)
Структура DEVICE_OBJECT используется операционной системой для представления объекта устройства. Объект устройства представляет собой логическое, виртуальное или физическое устройство, для которого драйвер обрабатывает запросы ввода-вывода.
Синтаксис
typedef struct _DEVICE_OBJECT {
CSHORT Type;
USHORT Size;
LONG ReferenceCount;
struct _DRIVER_OBJECT *DriverObject;
struct _DEVICE_OBJECT *NextDevice;
struct _DEVICE_OBJECT *AttachedDevice;
struct _IRP *CurrentIrp;
PIO_TIMER Timer;
ULONG Flags;
ULONG Characteristics;
__volatile PVPB Vpb;
PVOID DeviceExtension;
DEVICE_TYPE DeviceType;
CCHAR StackSize;
union {
LIST_ENTRY ListEntry;
WAIT_CONTEXT_BLOCK Wcb;
} Queue;
ULONG AlignmentRequirement;
KDEVICE_QUEUE DeviceQueue;
KDPC Dpc;
ULONG ActiveThreadCount;
PSECURITY_DESCRIPTOR SecurityDescriptor;
KEVENT DeviceLock;
USHORT SectorSize;
USHORT Spare1;
struct _DEVOBJ_EXTENSION *DeviceObjectExtension;
PVOID Reserved;
} DEVICE_OBJECT, *PDEVICE_OBJECT;
Члены
Type
Используется операционной системой для указания того, что объект является объектом устройства. Для объектов устройства значение этого элемента равно 3. Это член, доступный только для чтения.
Size
Задает размер объекта устройства в байтах. Этот размер включает указанное драйвером расширение устройства, на которое указывает элемент DeviceExtension , но не включает расширение непрозрачного объекта устройства, на которое указывает элемент DeviceObjectExtension . Размер является элементом, доступным только для чтения.
ReferenceCount
Используется диспетчером ввода-вывода для отслеживания количества открытых дескрипторов для устройства, связанных с объектом устройства. Это позволяет диспетчеру ввода-вывода избежать выгрузки драйвера при наличии необработанных дескрипторов для устройств драйвера. Это член, доступный только для чтения.
DriverObject
Указатель на объект драйвера (DRIVER_OBJECT), представляющий загруженный образ драйвера, который был входным для процедур DriverEntry и AddDevice . Этот элемент задается диспетчером ввода-вывода при успешном вызове IoCreateDevice или IoCreateDeviceSecure. Это член, доступный только для чтения.
NextDevice
Указатель на следующий объект устройства , если таковой имеется, который был создан тем же драйвером. Диспетчер ввода-вывода обновляет этот список при каждом успешном вызове IoCreateDevice или IoCreateDeviceSecure.
Драйвер, отличный от Plug and Play (PnP), который выгружается, должен пройти ("пройти") список своих объектов устройства и удалить их. Драйверу PnP не нужно идти по этому списку объектов устройств. Вместо этого драйверы PnP выполняют очистку во время операции PnP удаления устройства (IRP_MN_REMOVE_DEVICE).
Драйвер, динамически воссоздающий объекты устройства, также использует этот элемент. Это элемент для чтения и записи.
AttachedDevice
Указатель на подключенный объект устройства. Если присоединенный объект устройства отсутствует, этот элемент имеет значение NULL. Объект устройства, на который указывает элемент AttachedDevice , обычно является объектом устройства драйвера фильтра, который перехватывает запросы ввода-вывода, изначально предназначенные для устройства, представленного объектом устройства. Дополнительные сведения см. в разделах IoAttachDevice и IoAttachDeviceByPointer . Это непрозрачный элемент.
CurrentIrp
Указатель на текущий IRP, если у драйвера есть подпрограмма StartIo , точка входа которой была задана в объекте драйвера, и если драйвер в настоящее время обрабатывает IRP. В противном случае этот элемент имеет значение NULL. Дополнительные сведения см. в разделах IoStartPacket и IoStartNextPacket . Это член, доступный только для чтения.
Timer
Указатель на объект таймера. Это позволяет диспетчеру ввода-вывода вызывать подпрограмму таймера, предоставляемую драйвером, каждую секунду. Дополнительные сведения см. в разделе IoInitializeTimer. Это элемент для чтения и записи.
Flags
Драйверы устройств выполняют побитовую операцию OR с этим элементом во вновь созданных объектах устройства, используя одно или несколько следующих системных значений.
Дополнительные сведения о том, как задать элемент Flags , см. в разделе Инициализация объекта устройства.
| Значение | Значение |
|---|---|
| DO_VERIFY_VOLUME (0x00000002) | Драйверы съемных носителей устанавливают этот флаг при обработке запросов на передачу. Такие драйверы также должны проверка для этого флага в целевом объекте для запроса на передачу перед передачей каких-либо данных. Дополнительные сведения см. в разделе Поддержка съемных носителей . |
| DO_BUFFERED_IO (0x00000004) | Указывает тип буферизации, используемый диспетчером ввода-вывода для запросов ввода-вывода, отправляемых в стек устройств. Драйверы более высокого уровня ИЛИ этот элемент с тем же значением, что и следующий драйвер в стеке, за исключением драйверов самого высокого уровня. |
| DO_EXCLUSIVE (0x00000008) | Указывает, что драйвер обслуживает монопольное устройство, например видео, последовательное, параллельное или звуковое устройство. Драйверы WDM не должны устанавливать этот флаг. Дополнительные сведения см. в разделе Указание монопольного доступа к объектам устройств . |
| DO_DIRECT_IO (0x00000010) | См. DO_BUFFERED_IO. |
| DO_MAP_IO_BUFFER (0x00000020) | Этот флаг больше не используется. Драйверы не должны устанавливать этот флаг. |
| DO_DEVICE_INITIALIZING (0x00000080) | Диспетчер ввода-вывода устанавливает этот флаг при создании объекта устройства. Драйвер функции устройства или драйвер фильтра очищает флаг в своей подпрограмме AddDevice после этого: (1) присоединяет объект устройства к стеку устройств. (2) Устанавливает состояние питания устройства. (3) Выполняет побитовую операцию ИЛИ для элемента с одним из флагов питания (если это необходимо). Диспетчер Plug and Play (PnP) проверяет, снят ли флаг после возврата подпрограммы AddDevice. |
| DO_SHUTDOWN_REGISTERED (0x00000800) | Используется диспетчером ввода-вывода, чтобы указать, что драйвер зарегистрировал объект устройства для уведомлений о завершении работы. Этот флаг не должен использоваться драйверами. |
| DO_BUS_ENUMERATED_DEVICE (0x00001000) | Операционная система устанавливает этот флаг в каждом объекте физического устройства (PDO). Драйверы не должны изменять этот флаг. |
| DO_POWER_PAGABLE (0x00002000) | Драйверы с поддержкой страниц, совместимые с Microsoft Windows 2000 и более поздними версиями Windows, не являются частью пути разбиения по страницам и не требуют текущего входа, должны установить этот флаг. Система вызывает такие драйверы в IRQL = PASSIVE_LEVEL. Драйверы не могут установить как этот флаг, так и DO_POWER_INRUSH. Все драйверы для WDM, Microsoft Windows 98 и Windows Millennium Edition должны задавать DO_POWER_PAGABLE. |
| DO_POWER_INRUSH (0x00004000) | Драйверы устройств, для которых требуется текущий вход в систему при включении устройства, должны установить этот флаг. Драйвер не может установить и этот флаг, и DO_POWER_PAGABLE. |
| DO_DEVICE_TO_BE_RESET (0x04000000) | Диспетчер ввода-вывода устанавливает этот флаг в качестве сигнала для водителя шины о необходимости сбросить устройство. Другие драйверы не должны использовать этот флаг. |
| DO_DAX_VOLUME (0x10000000) | Указывает, что том является томом DAX. |
Characteristics
Указывает одну или несколько системных констант в сочетании с побитовой операцией ИЛИ, которые предоставляют дополнительные сведения об устройстве драйвера. К этим константам относятся следующие:
| Значение | Значение |
|---|---|
| FILE_AUTOGENERATED_DEVICE_NAME | Предписывает диспетчеру ввода-вывода создать имя устройства, а не вызывающий объект, указывающий deviceName при вызове этой подпрограммы. Диспетчер ввода-вывода гарантирует уникальность имени. Эта характеристика обычно задается драйвером шины PnP для создания имени объекта физического устройства (PDO) для дочернего устройства в той же шине. |
| FILE_CHARACTERISTIC_PNP_DEVICE | Указывает, что объект устройства является частью стека Plug and Play (PnP). Эта характеристика необходима, если водитель шины (или драйвер фильтра шины) регистрирует поддержку WMI для объекта устройства, который еще не получил запрос IRP_MN_START_DEVICE . FILE_CHARACTERISTIC_PNP_DEVICE также требуется, если драйвер функции или фильтра регистрируется для WMI перед присоединением к стеку устройств. |
| FILE_CHARACTERISTIC_TS_DEVICE | Указывает, что объект устройства является частью стека устройств служб терминалов. Драйверы не должны задавать эту характеристику. |
| FILE_CHARACTERISTIC_WEBDAV_DEVICE | Указывает, что на устройстве подключена файловая система распределенной разработки и управления версиями (WebDAV). Драйверы не должны задавать эту характеристику. |
| FILE_DEVICE_IS_MOUNTED | Указывает, что на устройстве подключена файловая система. Драйверы не должны задавать эту характеристику. |
| FILE_DEVICE_SECURE_OPEN | Предписывает диспетчеру ввода-вывода применить дескриптор безопасности объекта устройства к относительному открытию и открытию имени конечного файла для устройства. Дополнительные сведения см. в разделе Управление доступом к пространству имен устройств . |
| FILE_FLOPPY_DISKETTE | Указывает, что устройство является гибким диском. |
| FILE_READ_ONLY_DEVICE | Указывает, что устройство не может быть записано. |
| FILE_REMOTE_DEVICE | Указывает, что устройство удаленно. |
| FILE_REMOVABLE_MEDIA | Указывает, что запоминающее устройство поддерживает съемный носитель. Обратите внимание, что эта характеристика указывает на съемный носитель, а не съемный носитель. Например, драйверы для устройств с дисками JAZ должны указывать эту характеристику, а драйверы для флэш-дисков PCMCIA — нет. |
| FILE_VIRTUAL_VOLUME | Указывает, что том является виртуальным. Драйверы не должны задавать эту характеристику. |
| FILE_WRITE_ONCE_MEDIA | Указывает, что устройство поддерживает носитель с однократной записью. Драйверы не задают этот элемент напрямую. Дополнительные сведения о том, как задать характеристики устройства, см. в разделе Указание характеристик устройства . |
| FILE_CHARACTERISTIC_CSV | Указывает, что устройство является общим томом кластера (CSV). |
| FILE_DEVICE_ALLOW_APPCONTAINER_TRAVERSAL | Диспетчер операций ввода-вывода обычно выполняет полный проверка безопасности для обхода доступа к каждому открытому файлу, если клиент является контейнером приложения. Установка этого флага обходит этот принудительный доступ к обходу проверка, если маркер клиента уже имеет права обхода. |
| FILE_PORTABLE_DEVICE | Указывает, что базовый стек считает устройство переносимым. Это используется стеком хранилища и означает, что устройство не находится в контейнере локального компьютера и не находится в фиксированном типе шины. |
Vpb
Указатель на блок параметров тома (VPB), связанный с объектом устройства. Для драйверов файловой системы VPB может обеспечить подключение к любому неименованному объекту логического устройства, представляющего экземпляр подключенного тома. Это непрозрачный элемент.
DeviceExtension
Указатель на расширение устройства. Структура и содержимое расширения устройства определяются драйвером. Размер определяется драйвером и указывается в вызове драйвера IoCreateDevice или IoCreateDeviceSecure. Дополнительные сведения о расширениях устройств см. в разделе Расширения устройств. Это член, доступный только для чтения. Однако объект, на который указывает элемент, может быть изменен драйвером.
DeviceType
Задаются с помощью IoCreateDevice и IoCreateDeviceSecure , используя значение, указанное для параметра DeviceType этой подпрограммы. Дополнительные сведения см. в разделе Указание типов устройств .
StackSize
Указывает минимальное количество расположений стека в IRP, отправляемых этому драйверу. IoCreateDevice и IoCreateDeviceSecure устанавливают для этого элемента значение 1 во вновь созданных объектах устройства; Поэтому драйверы самого низкого уровня могут игнорировать этот элемент. Диспетчер ввода-вывода автоматически задает член StackSize в объекте устройства драйвера более высокого уровня соответствующее значение, если драйвер вызывает IoAttachDevice или IoAttachDeviceToDeviceStack. Только драйвер более высокого уровня, который связан с другим драйвером с IoGetDeviceObjectPointer , должен явно задать значение StackSize в собственных объектах устройства равным 1 + значение StackSize объекта устройства следующего ниже драйвера.
Queue
Используется внутри диспетчера ввода-вывода для постановки объекта устройства в очередь, когда это необходимо. Это непрозрачный элемент.
Queue.ListEntry
Структура LIST_ENTRY , содержащая указатели вперед и назад для списка, связанного вдвойне.
Queue.Wcb
Сведения о контексте устройства, используемые диспетчером ввода-вывода.
AlignmentRequirement
Указывает требование к выравниванию адресов устройства для передачи данных. Значение должно быть одним из FILE_XXX_ALIGNMENT значений, определенных в Wdm.h. Дополнительные сведения см. в разделах Инициализация объекта устройства, GetDmaAlignment и ZwQueryInformationFile .
DeviceQueue
Объект очереди устройства для объекта устройства. Объект очереди устройства содержит все irP, ожидающие обработки драйвером, связанным с объектом устройства. Дополнительные сведения см. в разделе Очереди IRP, управляемые драйвером . Это непрозрачный элемент.
Dpc
Объект отложенного вызова процедуры (DPC) для объекта устройства. Дополнительные сведения см. в статье Общие сведения об объектах DPC . Это непрозрачный элемент.
ActiveThreadCount
Зарезервировано для последующего использования. Это непрозрачный элемент.
SecurityDescriptor
Указывает дескриптор безопасности (SECURITY_DESCRIPTOR) для объекта устройства при создании объекта устройства. Если этот элемент имеет значение NULL, объект устройства получает параметры безопасности по умолчанию. Это элемент, доступный только для чтения, хотя его можно изменить с помощью функции ZwSetSecurityObject .
DeviceLock
Объект события синхронизации, выделенный диспетчером ввода-вывода. Диспетчер ввода-вывода получает объект события перед отправкой запроса на подключение или проверку подключения к драйверу файловой системы. Это непрозрачный элемент.
SectorSize
Если объект устройства не представляет том, этому элементу присваивается нулевое значение. Если объект устройства представляет том, этот элемент указывает размер сектора тома в байтах. Диспетчер ввода-вывода использует этот элемент, чтобы убедиться, что при отключении промежуточной буферизации все операции чтения, записи и операции установки положения файла правильно выровнены. Значение системных байтов на сектор по умолчанию используется при создании объекта устройства, однако драйверы файловой системы; и в редких случаях драйверы устаревших версий и минифильтров могут обновлять это значение на основе геометрии базового оборудования тома при подключении. Другие драйверы не должны изменять этот элемент.
Spare1
Зарезервировано для системного использования. Это непрозрачный элемент.
DeviceObjectExtension
Указатель на расширение объекта устройства, используемое диспетчером ввода-вывода и диспетчером PnP для хранения сведений о состоянии устройства. Это непрозрачный элемент.
Reserved
Зарезервировано для системного использования. Это непрозрачный элемент.
Комментарии
Операционная система представляет устройства по объектам устройства. Дополнительные сведения см. в разделе Объекты устройств и стеки устройств .
Драйверы создают объекты устройств с помощью процедур IoCreateDevice и IoCreateDeviceSecure . Дополнительные сведения о создании объектов устройств см. в разделе Создание объекта устройства.
Объект устройства является частично непрозрачным. Драйверы не задают члены объекта устройства напрямую, если не задокументировано иное. Дополнительные сведения о членах, которые драйверы могут изменять напрямую, см. в разделе Инициализация объекта устройства. Дополнительные сведения о других свойствах объектов устройства см. в разделе Свойства объектов устройства.
Непрозрачные элементы в объекте устройства должны считаться недоступными. Драйверы с зависимостями от расположений элементов объекта или доступом к непрозрачным элементам могут со временем оставаться переносимыми и совместимыми с другими драйверами.
Драйвер видеопорта, предоставляемый системой, настраивает поля объектов устройства, создаваемых от имени драйверов видео минипорта.
Предоставляемый системой драйвер порта SCSI настраивает поля объектов устройства, создаваемых от имени драйверов мини-портов SCSI.
Предоставляемая системой библиотека NDIS настраивает поля объектов устройств, создаваемых от имени драйверов минипорта NDIS.
Требования
| Требование | Значение |
|---|---|
| Заголовок | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h) |