WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 命令
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 命令检索可以保存指定类型的对象的文件夹的对象 ID。 与暴力对象枚举相比,客户端可以通过此命令更快地发现设备存储特定对象的位置。
命令类别
WPD_CATEGORY_DEVICE_HINTS
参数
驱动程序需要以下参数。
参数 | VarType | 说明 |
---|---|---|
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | 必需。 调用方希望查找其容器的对象类型。 例如,若要查找用于在数码相机上保存图像的顶级文件夹,调用方将提交WPD_CONTENT_TYPE_IMAGE。 有关 Windows 可移植设备定义的对象类型列表,请参阅 对象要求 。 |
返回值
驱动程序应返回以下结果。
结果 | VarType | 说明 |
---|---|---|
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | 必需。 类型的 IPortableDevicePropVariantCollection VT_LPWSTR值,用于指定包含调用参数所指示类型的对象的文件夹的对象 ID。 如果未找到任何文件夹,则此列表应为空列表。结果指示的文件夹可能包含也可能不包含其他内容类型的对象。 有关文件夹限制的信息,请参阅 WPD_FOLDER_CONTENT_TYPES_ALLOWED 属性。 |
WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | 必需。 指示处理命令成功或失败的 HRESULT 。 如果调用方发出无效请求,驱动程序应返回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) ,不需要返回任何其他结果值。 错误代码包括 Windows 可移植设备错误代码 或任何其他适当的错误代码。 |
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | 可选。 特定于驱动程序的错误代码。 这通常仅用于驱动程序测试,或者驱动程序、设备和客户端都是一起设计的。 |
调用方法
只能使用 IPortableDevice::SendCommand 直接调用。
要求
要求 | 值 |
---|---|
标头 |
|