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)

Consulte también

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT