设备对象
设备对象支持以下属性。 应用程序可以通过查询根对象 (指定定义的 WPD_DEVICE_OBJECT_ID 常量对象 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 可移植设备定义的一组特定命令。 对象或设备支持的命令取决于其类型、功能和功能。
下表按功能描述了应用于设备的命令类。 通常,设备属于多个类别,它应支持所有适用类别的命令。 例如,具有相机的移动电话分为三类:所有设备、短信设备和静止图像捕获设备。 自定义驱动程序和客户端应用程序可以支持你定义的其他命令或属性,但必须支持以下命令。 有关每个命令类别下的特定命令的说明,请参阅 命令。
说明 | 命令类别 |
---|---|
所有设备。 |
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 |
可以发送短信服务 (短信) 消息的设备,例如移动电话。 发送短信通常称为“短信”。 | WPD_CATEGORY_SMS |
充当存储设备的设备。 其中包括外部驱动器。如果设备支持设置存储格式或将对象从一个位置移动到另一个位置的功能,则驱动程序应支持此类别。 |
WPD_CATEGORY_STORAGE |