KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (modo definido por el controlador)
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)