Поделиться через

Объект Device

  • Статья

Объект устройства поддерживает следующие свойства. Приложение может запросить эти свойства, запросив корневой объект (указав определенный WPD_DEVICE_OBJECT_ID идентификатор постоянного объекта). Все значения объекта устройства доступны только для чтения.

Если данное устройство реализует категорию WPD_FUNCTIONAL_CATEGORY_DEVICE , оно также должно поддерживать свойства, связанные с этой категорией.

Имя свойства Обязательный или необязательный
WPD_OBJECT_ID Обязательный. Значение равно WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Обязательный. Значением является пустая строка.
WPD_OBJECT_NAME Требуется, если объект представляет файл.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Обязательный.
WPD_OBJECT_ISHIDDEN Требуется, если объект устройства не должен отображаться пользователю.
WPD_OBJECT_REFERENCES Требуется, если объект устройства имеет ссылки на другие объекты.
WPD_OBJECT_KEYWORDS Необязательный элемент.
WPD_OBJECT_SYNC_ID Необязательный элемент.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Необязательный элемент.
WPD_DEVICE_SYNC_PARTNER Необязательный элемент.
WPD_DEVICE_FIRMWARE_VERSION Обязательный.
WPD_DEVICE_POWER_LEVEL Рекомендуется, если на устройстве установлен аккумулятор.
WPD_DEVICE_POWER_SOURCE (рекомендуется).
WPD_DEVICE_PROTOCOL (рекомендуется).
WPD_DEVICE_MANUFACTURER Обязательный.
WPD_DEVICE_MODEL Обязательный.
WPD_DEVICE_SERIAL_NUMBER Обязательный.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Требуется, если устройство поддерживает неиспотребимые объекты; то есть, если его можно использовать для простого хранения данных.
WPD_DEVICE_DATETIME Необязательный элемент.
WPD_DEVICE_FRIENDLY_NAME (рекомендуется).
WPD_DEVICE_SUPPORTED_DRM_SCHEME Рекомендуется, если устройство поддерживает управление цифровыми правами (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Рекомендуется, если устройство поддерживает предпочтительный порядок форматирования.
WPD_DEVICE_TYPE (рекомендуется).
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Необязательный элемент.
WPD_DEVICE_MODEL_UNIQUE_ID Необязательный элемент.
WPD_DEVICE_TRANSPORT (рекомендуется).
WPD_DEVICE_USE_DEVICE_STAGE Необязательный элемент.
WPD_FUNCTIONAL_OBJECT_CATEGORY Обязательный.

Типичные ресурсы

Эти объекты обычно не размещают ресурсы.

Команды

Помимо свойств устройства должны поддерживать определенный набор команд, определенных переносными устройствами Windows. Команды, поддерживаемые объектом или устройством, зависят от их типа, функциональности и возможностей.

В следующей таблице описаны классы команд, которые применяются к устройствам по функциональным возможностям. Как правило, устройство относится к нескольким категориям и должно поддерживать команды для всех применимых категорий. Например, мобильный телефон с камерой будет подпадать под три категории: все устройства, УСТРОЙСТВА SMS и устройства для захвата изображений. Пользовательский драйвер и клиентское приложение могут поддерживать дополнительные команды или свойства, которые вы определяете, но должны поддерживать следующие команды. Описание конкретных команд, которые относятся к каждой категории команд, см. в разделе Команды.

Описание Категории команд
Все устройства. WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON
WPD_CATEGORY_OBJECT_ENUMERATION
WPD_CATEGORY_OBJECT_MANAGEMENT
WPD_CATEGORY_OBJECT_PROPERTIES
WPD_CATEGORY_OBJECT_PROPERTIES_BULK
WPD_CATEGORY_OBJECT_RESOURCES
Устройства, которые могут записывать неподвижные изображения, например цифровые камеры. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Устройства, которые могут отправлять сообщения службы коротких сообщений (SMS), например мобильные телефоны. Отправка SMS-сообщений часто называется текстовыми сообщениями. WPD_CATEGORY_SMS
Устройства, которые работают в качестве запоминающих устройств. К ним относятся внешние диски. Если устройство поддерживает возможность форматирования хранилища или перемещения объектов из одного расположения в другое, драйвер должен поддерживать эту категорию.
 WPD_CATEGORY_STORAGE

Требования к объектам