estructura KSPROPERTY_CAMERACONTROL_S_EX (ksmedia.h)

Artículo
03/18/2023

Especifica una operación de control de cámara, incluida la configuración del flash, las propiedades del control de patillas de imagen, la región de interés en la imagen o la estabilización de vídeo. En esta estructura se describen las propiedades basadas en filtros del conjunto de propiedades PROPSETID_VIDCAP_CAMERACONTROL .

Se admite a partir de Windows 8.

Sintaxis

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Miembros

Property

Especifica una estructura KSPROPERTY inicializada que describe el conjunto de propiedades, el identificador de propiedad y el tipo de solicitud.

Value

Especifica el valor de la propiedad. Este miembro es de lectura y escritura.

Flags

Indica, para las solicitudes Get, la configuración actual de la propiedad especificada de los valores que se enumeran a continuación. Indica, para Establecer solicitudes, la configuración deseada para la propiedad especificada de los valores que se enumeran a continuación. Este miembro puede ser un OR bit a bit de los siguientes valores definidos en Ksmedia.h:

Valor	Descripción
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Indica que la configuración se controla automáticamente. Si el controlador recibe este valor, debe establecer el control de cámara de forma sincrónica en modo automático y, a continuación, volver.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Indica que la configuración se controla manualmente. Si el controlador recibe este valor, debe establecer el control de cámara de forma sincrónica en modo manual y, a continuación, volver.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Indica si el controlador debe realizar la operación de control de cámara de forma asincrónica, donde la aplicación ha emitido un comando para que el controlador configure la configuración del control de cámara de antemano de tomar una foto. Esta marca solo debe establecerse si se establecen KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL o KSPROPERTY_CAMERACONTROL_FLAGS_AUTO . Si se establece este valor de marca y el valor de marca de KSPROPERTY_CAMERACONTROL_FLAGS_AUTO , el controlador debe iniciar un subproceso de trabajo para iniciar una operación de control solicitada y debe rechazar todas las demás solicitudes de la misma operación hasta que haya completado la primera. Una vez completada correctamente la operación, el controlador debe desencadenar el evento KSEVENTSETID_CameraAsyncControl .

Capabilities

Si se establece, indica que cuando la aplicación envía una consulta, el controlador debe devolver el valor del miembro Capabilities de la estructura de control de cámara adecuada de la lista siguiente.

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 escritorio de Windows.

Comentarios

Cuando se completa o se cancela una operación de foco de cámara solicitada, el controlador debe generar un evento especificado por el valor de enumeración KSEVENT_CAMERACONTROL_FOCUS .