Propriedades de controle de câmera estendida

A interface de controle de câmera estendida, disponível a partir de Windows 8, é usada para controlar os recursos da câmera durante a captura de imagem. O driver pode controlar estes recursos de câmera:

• flash da câmera
• se o pino de imagem e o pino de registro são mutuamente exclusivos
• a região de interesse na imagem
• estabilização de vídeo

O driver também pode optar por executar uma operação de controle de câmera de forma assíncrona, o que significa que todas as solicitações para uma operação são rejeitadas até que a primeira solicitação seja concluída. Se o driver tiver executado com êxito operações de controle de câmera assíncrona, ele deverá disparar o evento KSEVENTSETID_CameraAsyncControl . Confira KSPROPERTY_CAMERACONTROL_S_EX para obter mais informações.

Os aplicativos UWP podem acessar essas propriedades para configurar a câmera:

Propriedades

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Usado para ativar ou desativar o flash da câmera ou para colocar o flash no modo automático.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Usado para identificar se o pino de imagem e o pino de registro da câmera são mutuamente exclusivos.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Usado para obter ou definir a característica da região de interesse de uma câmera.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Usado para obter ou definir as características de estabilização de vídeo de uma câmera.

As propriedades a seguir estão disponíveis a partir do Windows 8.1.

Termo	Descrição
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Usado para obter ou definir um modo normal de sequência de fotos ou para a câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Usado para obter a taxa de quadros de captura de fotos atual quando o modo de foto para a câmera é o modo de sequência.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Usado para obter ou definir a taxa máxima de quadros de captura para uma câmera quando ela estiver no modo de sequência de fotos.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Usado para obter ou definir a hora do gatilho para o driver da câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Usado para obter ou definir o estado de início quente (câmera pronta).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Usado para obter ou definir a taxa máxima de quadros possível nos pinos de captura de vídeo em uma determinada resolução.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Usado para obter ou definir a funcionalidade de miniatura para a câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Usado para obter ou definir um modo definido pelo driver que representa uma coleção de controles predefinidos.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Usado para obter ou definir o método em que o flash de uma câmera é usado em condições de pouca luz.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Usado para obter ou definir a operação de modo flash para o modo de foto normal e de sequência da câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Usado para obter ou definir se o processamento automático ocorre para o saldo em branco ou para um valor de temperatura manual.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Usado para obter ou definir se a câmera é otimizada para operação de foto ou vídeo.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Usado para obter ou definir se o processamento automático ocorre para exposição ou um valor de tempo manual é usado.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Usado para obter ou definir os modos de foco automático, manual e predefinido da câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Usado para obter ou definir a configuração de ISO predefinida ou automática para a câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Usado para obter o campo de exibição e o ângulo de inclinação da posição da câmera.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Usado para obter ou definir a configuração de ajuste do controle de exposição.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Usado para obter o ângulo de inclinação e guinada da posição da câmera.

Essas estruturas e enumerações dão suporte à interface de controle de câmera estendida:

Estruturas

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

Enumerações

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

O código de driver de exemplo que implementa essa interface é dado em How To Implement Extended Camera Control Properties.