estrutura KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)
Descreve as propriedades de controle ROI (região de interesse) no conjunto de propriedades de controle de câmera PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST. A região de interesse é um retângulo na imagem que é usada para concentrar a câmera. Essa estrutura especifica valores de propriedade que são usados em solicitações para o driver da câmera.
Sintaxe
typedef struct {
RECT FocusRect;
BOOL AutoFocusLock;
BOOL AutoExposureLock;
BOOL AutoWhitebalanceLock;
union {
ULONG Capabilities;
ULONG Configuration;
};
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;
Membros
FocusRect
Uma estrutura RECT que especifica a região retangular na qual o dispositivo deve definir o foco. Essa estrutura está disponível apenas para aplicativos do Windows.
Se FocusRect não for um valor válido ou se todos os membros da estrutura RECT forem zero, o dispositivo deverá concentrar o centro da imagem e os membros restantes dessa estrutura poderão ser ignorados.
As coordenadas do retângulo são referentes à resolução de vídeo de visualização.
AutoFocusLock
Se TRUE, o dispositivo deverá bloquear o foco para o valor atual.
Esse membro deverá ser ignorado se FocusRect não for um valor válido.
AutoExposureLock
Se TRUE, o dispositivo deverá bloquear a exposição ao valor atual.
Esse membro deverá ser ignorado se FocusRect não for um valor válido.
AutoWhitebalanceLock
Se TRUE, o dispositivo deverá bloquear a configuração de saldo em branco para o valor atual.
Esse membro deverá ser ignorado se FocusRect não for um valor válido.
Capabilities
Indica se o dispositivo e o driver dão suporte à configuração da região de interesse automaticamente ou manualmente. Esse membro é um OR bit a bit destes valores possíveis:
| Valor | Significado |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | O dispositivo e o driver podem definir automaticamente a região de interesse. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL | O usuário pode definir manualmente a região de interesse. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC | Os recursos de controle ROI são executados de forma assíncrona. Essa funcionalidade está disponível a partir do Windows 8.1. |
Configuration
Sinalizadores de configuração para operações de controle para a região. Essa é uma combinação OR bit a bit dos valores a seguir.
Esse membro está disponível a partir do Windows 8.1.
| Valor | Significado |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | Defina o foco automático para a região. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | Defina a exposição automática para a região. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB | Defina o saldo automático de branco para a região. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | Habilite a convergência de objetos na região. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Cabeçalho | ksmedia.h (inclua Ksmedia.h) |