KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOSTABILIZATION

Este control de propiedad extendida se usa para controlar la estabilización de vídeo digital en driver\MFT0.

Tabla de resumen de uso

Ámbito	Control	Tipo
versión 1	Anclar	Sincrónico

Las marcas siguientes que se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marca marcas de campo para controlar la estabilización de vídeo digital en driver\MFT0. De forma predeterminada, el controlador debe tener desactivada la estabilización de vídeo.

#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF       0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO      0x0000000000000002

Si el controlador no admite la estabilización de vídeo digital, el controlador no debe implementar este control.

Si el controlador admite este control, debe admitir VIDEOSTABILIZATION_ON\OFF.

La llamada SET de este control no tiene ningún efecto cuando el pin de vídeo está en cualquier estado superior al estado KSSTATE_STOP. El controlador rechazará la llamada SET recibida si el pin de vídeo no está en estado de detención y devuelve STATUS_INVALID_DEVICE_STATE. En una llamada GET, el controlador debe devolver la configuración actual en el campo Marcas.

Cuando se utiliza este control en el contexto de un perfil, el perfil actuará como sugerencia al conductor para el modo de calidad. El controlador puede determinar si se va a optimizar para una baja latencia o una alta calidad cuando la estabilización de vídeo está activada en función del perfil seleccionado, por ejemplo, videoconferencia o grabación de vídeo de alta calidad.

Nota

PROPSETID_VIDCAP_CAMERACONTROL_VIDEO_STABILIZATION quedará en desuso para Windows 10.

En la tabla siguiente se describen las funcionalidades de marca.

Marca	Descripción
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF	Se trata de una funcionalidad obligatoria. Cuando se especifica, la estabilización de vídeo digital está deshabilitada en driver\MFT0.
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON	Se trata de una funcionalidad obligatoria. Cuando se especifica, la estabilización de vídeo digital está habilitada en driver\MFT0 y la configuración predeterminada de relleno de análisis está establecida en el controlador. Esta marca es mutuamente excluyente con las marcas AUTO y OFF.
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO	Esta funcionalidad es opcional. Cuando se especifica, el controlador que admite dicha funcionalidad determinará si se debe realizar la estabilización de vídeo y la cantidad de estabilización que se va a aplicar en función del análisis de la escena y del escenario de captura. Esta marca es mutuamente excluyente con las marcas ON y OFF.

Nota

En función de la implementación, el controlador puede asignar internamente el búfer sobreestable o la canalización.

Si el controlador va a asignar el búfer sobreexplorado, el controlador debe anunciar tanto el tipo de medio normal como el tipo de medio sobreescanado. El MFT0 debe anunciar el tipo de medio normal. Al establecer el tipo de medio normal en el tipo de medio de salida de MFT0, el MFT0 debe seleccionar el tipo de medio sobresanchado correspondiente del controlador anunciados como su tipo de medio de entrada, si la estabilización de vídeo está activada. Si la estabilización de vídeo está desactivada, el MFT0 debe seleccionar el tipo de medio normal como su tipo de medio de entrada. El MFT0 debe devolver MF_E_INVALIDMEDIATYPE si el tipo de medio sobresanchado se establece como su tipo de medio de salida cuando se activa la estabilización de vídeo.

Si el controlador asigna un búfer sobreestable, tanto el controlador como el MFT0 deben anunciar los tipos de medios normales. MFT0 debe establecer el tipo de medio normal para su tipo de medio de entrada y el tipo de medio de salida.

Con el fin de admitir la estabilización de vídeo basada en efectos (es decir, la estabilización de vídeo no realizada en el controlador ni en MFT0), el controlador y MFT0 deben anunciar además el tipo de medio sobreexplorado independientemente. En este caso, el controlador y MFT0 exponen los tipos de medios normales y overscanned. Las reglas siguientes se aplicarán para asegurarse de que la estabilización de vídeo basada en el efecto y el controlador\MFT0 funcionan correctamente.

• Si un tipo de medio sobresanchado se establece como el tipo de medio de salida MFT0 mientras que la estabilización de vídeo basada en driver\MFT0 está activada, MFT0 debe devolver MF_E_INVALIDMEDIATYPE.

• Si un tipo de medio normal se establece como el tipo de medio de salida MFT0, la aplicación debe devolver un error en el intento de activar la estabilización de vídeo basada en el efecto si la estabilización de vídeo basada en el efecto solo puede tomar el tipo de medio sobreexplorado.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER al usar el control de estabilización de vídeo.

Miembro	Descripción
Versión	Debe ser 1.
PinId	Debe ser el identificador de pin asociado al pin de vídeo.
Size	Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).
Resultado	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 de KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX admitidas, tal y como se ha definido anteriormente.
Marcas	Se trata de un campo de lectura y escritura. Puede ser cualquiera de las marcas de KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX definidas anteriormente.

Requisitos

Encabezado

Ksmedia.h