KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (modo definido por el controlador)

  • Artículo

La propiedad del modo de escena selecciona un modo definido por el controlador que representa una colección de controles preestablecidos. El controlador determina los valores preestablecidos asignados a un modo de escena y habilita esos valores de control cuando se selecciona una escena.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad
Sí Sí Filtrar KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

El valor de propiedad (datos de operación) contiene una estructura de KSCAMERA_EXTENDEDPROP_HEADER y una estructura de KSCAMERA_EXTENDEDPROP_VALUE . El KSCAMERA_EXTENDEDPROP_VALUE es necesario, pero se omite el miembro Value .

El tamaño total de los datos de propiedad es sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). El miembro Size de KSCAMERA_EXTENDEDPROP_HEADER se establece en este tamaño total de datos de propiedad.

El miembro Capability de KSCAMERA_EXTENDEDPROP_HEADER contiene una combinación OR bit a bit de uno o varios de los siguientes modos de escena admitidos por el controlador.

Modo de escena Descripción
KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO Modo de aroma automático. Los controles se encuentran en su configuración automática.
KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO Modo de escena de macro (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT Modo de escena vertical (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT Modo de escena deportiva (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW Modo de escena de nieve (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT Modo de escena nocturna (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH Modo de escena de playa (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET Modo de escena sunset (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT Modo de escena de velas (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE Modo de escena horizontal (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT Modo de escena vertical nocturna (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT Modo de escena retroiluminada (controlador definido).
KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL Los controles se cambian manualmente y no se establecen modos de escena predefinidos.

El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene el modo de escena establecido actualmente para la cámara. El modo de escena predeterminado para una cámara siempre se KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.

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

Comentarios

Obtención de la propiedad

Al responder a una solicitud de KSPROPERTY_TYPE_GET, el controlador establece los miembros del KSCAMERA_EXTENDEDPROP_HEADER en lo siguiente.

Miembro Valor
Versión 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Resultado 0
Capacidad KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (se admiten valores de modo de escena)
Marcas Configuración del valor del modo de escena actual (solo un valor)

Si no se estableció previamente ningún modo de escena, Flags se establece en KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (valor predeterminado).

Establecimiento de la propiedad

Cuando se establece la propiedad , una solicitud de KSPROPERTY_TYPE_SET, el miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contendrá el modo de escena que se va a habilitar.

Requisitos

Versión: Disponible a partir de Windows 8.1

Rúbrica: Ksmedia.h (incluye Ksmedia.h)

Consulte también

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE