WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE 命令

WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE 命令由静止图像功能对象启动静态图像捕获。 如果由于拍照而创建了新对象,驱动程序应发送 WPD_EVENT_OBJECT_ADDED 事件。

命令类别

WPD_CATEGORY_STILL_IMAGE_CAPTURE

parameters

驱动程序需要以下参数。

参数 VarType 说明
WPD_PROPERTY_COMMON_COMMAND_TARGET VT_LPWSTR 必需。 设备上应拍摄照片的静止图像捕获功能对象的对象 ID。每个静止图像捕获功能对象可以具有不同的设置,并且可以引用设备上的不同硬件 (例如手机) 的前置或后置摄像头,此参数指示要使用的硬件。

返回值

驱动程序应返回以下结果。

结果 VarType 说明
WPD_PROPERTY_COMMON_HRESULT VT_ERROR 必需。 指示执行命令是成功还是失败的 HRESULT 。 如果调用方发出无效请求,驱动程序应返回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) ,并且不需要返回任何其他结果值。 错误代码包括 Windows 可移植设备错误代码 或任何其他相应的错误代码。
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE VT_UI4 可选。 特定于驱动程序的错误代码。 设备供应商通常使用此值来改进使用其应用程序时设备错误的诊断。 常规用途应用程序将忽略它,而仅依赖于WPD_PROPERTY_COMMON_HRESULT。

调用方法

只能使用 IPortableDevice::SendCommand 直接调用。

要求

要求
标头
PortableDevice.h

另请参阅

命令