Compartir a través de

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

  • Artículo

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM se usa para controlar el zoom digital. Se define en la enumeración KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY y se usa para obtener y establecer la relación de zoom y obtener intervalos de zoom del controlador. En Windows 10, este control se extiende para admitir también el zoom suave.

Tabla de resumen de uso

Ámbito Control Tipo

versión 1

Filtrar

Sincrónico

Las marcas siguientes se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marca el campo para controlar el zoom suave frente al zoom directo. El controlador define el valor predeterminado.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

Si el controlador admite este control, debe admitir KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT.

Si el controlador no admite el zoom digital, el controlador no debe implementar este control.

En la tabla siguiente se describen las funcionalidades de marca.

Marca Descripción

KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT

Se trata de una funcionalidad obligatoria. Cuando se especifica, el controlador decidirá si se debe aplicar un zoom directo o un zoom suave y el zoom al factor de zoom de destino especificado en VideoProc.Value.ul en consecuencia. Esta marca es mutuamente excluyente con las marcas DIRECT y SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT

Se trata de una funcionalidad obligatoria. Cuando se especifica, el controlador se acercará al factor de zoom de destino especificado en VideoProc.Value.ul lo antes posible. Esta marca es mutuamente excluyente con las marcas AUTO y SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH

Esta funcionalidad es opcional. Cuando se especifica, el controlador se acercará al factor de zoom de destino especificado en VideoProc.Value.ul gradualmente de forma fluida. El número de fotogramas que se tarda en alcanzar el factor de zoom especificado es hasta el controlador. Esta marca es mutuamente excluyente con las marcas AUTO y DIRECT.

Para cada llamada GET , el controlador debe notificar los intervalos de zoom actuales permitidos en función de las configuraciones o la configuración actuales.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER cuando se usa la propiedad KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Miembro Descripción

Versión

Debe ser 1,

PinId

Debe ser KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Size

Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING),

Resultado

Esto indica los resultados del error de la última operación SET. Si no se ha realizado ninguna operación SET, debe ser 0.

Capacidad

Debe ser un OR bit a bit de las marcas admitidas definidas anteriormente.

Marcas

Se trata de un campo de lectura y escritura. Puede ser cualquiera de las marcas admitidas definidas anteriormente.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING para la propiedad KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Miembro Descripción

Mode

Esto no se usa y debe ser 0.

Min/Max/Step

El paso min/max/step contiene el mínimo,máximo/incremento de la relación de zoom compatible con el controlador de cámara en formato Q16. El controlador debe devolver estos valores para las operaciones GET .

VideoProc

Para las operaciones SET , VideoProc.Value.ul debe especificar la relación de zoom dentro del intervalo descrito por el parámetro Min/Max/Step. Para las operaciones GET , el controlador debe devolver la relación de zoom actual.

Reservado

Esto no se usa. El controlador debe omitirlo.

Este control de propiedad es sincrónico y no se puede cancelar.

Requisitos

Encabezado

 Ksmedia.h