Compartilhar via


Comando WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE

O comando WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE inicia uma captura de imagem parada por um objeto funcional de imagem ainda. Se um novo objeto for criado como resultado de tirar uma foto, o driver deverá enviar o evento WPD_EVENT_OBJECT_ADDED .

Categoria de comando

WPD_CATEGORY_STILL_IMAGE_CAPTURE

Parâmetros

O driver espera os parâmetros a seguir.

Parâmetro VarType Descrição
WPD_PROPERTY_COMMON_COMMAND_TARGET VT_LPWSTR Obrigatórios. A ID do objeto funcional de captura de imagem ainda no dispositivo que deve tirar a imagem. Cada objeto funcional de captura de imagem ainda pode ter configurações diferentes e pode se referir a hardware diferente em um dispositivo (por exemplo, uma câmera frontal ou traseira de um telefone), e esse parâmetro indica qual deles usar.

Valor Retornado

O driver deve retornar os resultados a seguir.

Result VarType Descrição
WPD_PROPERTY_COMMON_HRESULT VT_ERROR Obrigatórios. Um HRESULT que indica êxito ou falha na execução do comando. Se o chamador estiver fazendo uma solicitação inválida, o driver deverá retornar HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) e não será necessário retornar nenhum outro valor de resultado. Os códigos de erro incluem códigos de erro dispositivos portáteis do Windows ou quaisquer outros códigos de erro apropriados.
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE VT_UI4 Opcional. Um código de erro específico do driver. Esse valor normalmente é usado por fornecedores de dispositivos para melhorar o diagnóstico de erros de dispositivo ao usar seus aplicativos. Em vez disso, os aplicativos de uso geral o ignorariam e dependeriam apenas de WPD_PROPERTY_COMMON_HRESULT.

Chamando métodos

Só pode ser chamado diretamente usando IPortableDevice::SendCommand.

Requisitos

Requisito Valor
parâmetro
PortableDevice.h

Confira também

Comandos