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

Объект устройства

  • Статья

Объект устройства поддерживает следующие свойства. Приложение может запрашивать эти свойства, запрашивая корневой объект (указав определенный идентификатор объекта константы 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 Рекомендуется, если устройство поддерживает digital Rights Management (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

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