Команда WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE

Команда WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE инициирует захват неподвижного изображения функциональным объектом неподвижного изображения. Если в результате создания снимка создается новый объект, драйвер должен отправить событие WPD_EVENT_OBJECT_ADDED .

Категория команды

WPD_CATEGORY_STILL_IMAGE_CAPTURE

Параметры

Драйвер ожидает следующие параметры.

Параметр	VarType	Описание
WPD_PROPERTY_COMMON_COMMAND_TARGET	VT_LPWSTR	Обязательный. Идентификатор объекта неподвижного изображения захватывает функциональный объект на устройстве, которое должно сделать снимок. Каждый объект захвата неподвижного изображения может иметь разные параметры и ссылаться на другое оборудование на устройстве (например, переднюю или заднюю камеру телефона), и этот параметр указывает, какое из них следует использовать.

Возвращаемое значение

Драйвер должен вернуть следующие результаты.

Результат	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

См. также раздел

Команды