设备对象

设备对象支持以下属性。 应用程序可以通过查询根对象(指定定义的 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

对象要求