estructura KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)
Describe las propiedades de control de región de interés (ROI) en el conjunto de propiedades de control de cámara PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST . La región de interés es un rectángulo en la imagen que se usa para centrar la cámara. Esta estructura especifica los valores de propiedad que se usan en las solicitudes al controlador de cámara.
Sintaxis
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;
Miembros
FocusRect
Estructura RECT que especifica la región rectangular en la que el dispositivo debe establecer el foco. Esta estructura solo está disponible para las aplicaciones de Windows.
Si FocusRect no es un valor válido o si todos los miembros de la estructura RECT son cero, el dispositivo debe centrar el centro de la imagen y se pueden omitir los miembros restantes de esta estructura.
Las coordenadas del rectángulo se refieren a la resolución de vídeo de vista previa.
AutoFocusLock
Si es TRUE, el dispositivo debe bloquear el foco en el valor actual.
Este miembro debe omitirse si FocusRect no es un valor válido.
AutoExposureLock
Si es TRUE, el dispositivo debe bloquear la exposición al valor actual.
Este miembro debe omitirse si FocusRect no es un valor válido.
AutoWhitebalanceLock
Si es TRUE, el dispositivo debe bloquear la configuración del equilibrio de blancos en el valor actual.
Este miembro debe omitirse si FocusRect no es un valor válido.
Capabilities
Indica si el dispositivo y el controlador admiten la configuración de la región de interés de forma automática o manual. Este miembro es or bit a bit de estos valores posibles:
| Valor | Significado |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | El dispositivo y el controlador pueden establecer automáticamente la región de interés. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL | El usuario puede establecer manualmente la región de interés. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC | Las características de control roi se ejecutan de forma asincrónica. Esta funcionalidad está disponible a partir de Windows 8.1. |
Configuration
Marcas de configuración para las operaciones de control de la región. Se trata de una combinación OR bit a bit de los siguientes valores.
Este miembro está disponible a partir de Windows 8.1.
| Valor | Significado |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | Establezca el foco automático para la región. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | Establezca la exposición automática para la región. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB | Establezca el equilibrio de blancos automático para la región. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | Habilite la convergencia de objetos en la región. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Encabezado | ksmedia.h (incluya Ksmedia.h) |