KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

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