VideoDeviceController Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Controla la configuración del dispositivo en la cámara.
public ref class VideoDeviceController sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class VideoDeviceController final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class VideoDeviceControllerPublic NotInheritable Class VideoDeviceController- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
Para obtener una instancia de este objeto, recupere la propiedad MediaCapture.VideoDeviceController .
Algunos controladores pueden requerir que la vista previa del dispositivo de cámara esté en estado de ejecución para poder determinar qué controles son compatibles con VideoDeviceController. Si comprueba si un control determinado es compatible con VideoDeviceController antes de que se ejecute la secuencia de vista previa, el control puede describirse como no compatible aunque sea compatible con el dispositivo de vídeo.
Nota:
Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulte Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1703 | 15063 | GetDevicePropertyByExtendedId |
| 1703 | 15063 | GetDevicePropertyById |
| 1703 | 15063 | Identificador |
| 1703 | 15063 | SetDevicePropertyByExtendedId |
| 1703 | 15063 | SetDevicePropertyById |
| 1803 | 17134 | VideoTemporalDenoisingControl |
| 1903 | 18362 | InfraredTorchControl |
| 2004 | 19041 | PanelBasedOptimizationControl |
Propiedades
| AdvancedPhotoControl |
Obtiene el control de captura de fotos avanzada para este dispositivo de vídeo. |
| BacklightCompensation |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la compensación de luz inversa habilitada en la cámara. |
| Brightness |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer el nivel de brillo en la cámara. |
| CameraOcclusionInfo |
Obtiene un objeto CameraOcclusionInfo que se puede usar para obtener el estado de oclusión actual de una cámara y recibir notificaciones cuando cambia el estado de oclusión. |
| Contrast |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer el nivel de contraste en la cámara. |
| DesiredOptimization |
Obtiene o establece un valor que indica las optimizaciones que el dispositivo de captura debe usar para priorizar imágenes de alta calidad, baja latencia o bajo consumo de energía durante la captura de vídeo. |
| DigitalWindowControl |
Obtiene un digitalWindowControl que permite a las aplicaciones capturar una subregión del sensor del dispositivo de captura. |
| Exposure |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer el tiempo de exposición de la cámara. |
| ExposureCompensationControl |
Obtiene el control de compensación de exposición para este dispositivo de vídeo. |
| ExposureControl |
Obtiene el control de exposición de este dispositivo de vídeo. |
| ExposurePriorityVideoControl |
Obtiene la clase ExposurePriorityVideoControl asociada con VideoDeviceController. |
| FlashControl |
Obtiene el control flash de este dispositivo de vídeo. |
| Focus |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración de foco de la cámara. |
| FocusControl |
Obtiene el control de foco de este dispositivo de vídeo. |
| HdrVideoControl |
Obtiene el HdrVideoControl asociado con VideoDeviceController. Esto le permite habilitar y deshabilitar el modo de captura de vídeo de alto rango dinámico (HDR) en los dispositivos que lo admiten. |
| Hue |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración de tono de la cámara. |
| Id |
Obtiene una cadena que contiene el identificador del controlador de dispositivo de vídeo. |
| InfraredTorchControl |
Obtiene el control de antorcha de infrarrojos para el dispositivo de vídeo seleccionado. |
| IsoSpeedControl |
Obtiene el control de velocidad de película ISO para este dispositivo de vídeo. |
| LowLagPhoto |
Obtiene el control de foto de retardo de obturación baja para este dispositivo de vídeo. |
| LowLagPhotoSequence |
Obtiene el control de secuencia de fotos de retardo de obturación baja para este dispositivo de vídeo. |
| OpticalImageStabilizationControl |
Obtiene el objeto OpticalImageStabilizationControl asociado con VideoDeviceController. |
| Pan |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración panorámica de la cámara. |
| PanelBasedOptimizationControl |
Obtiene el PanelBasedOptimizationControl que, cuando se admite, permite a una aplicación habilitar el controlador de dispositivo de captura para optimizar la funcionalidad de captura de cámara en función de la ubicación del panel de la cámara. |
| PhotoConfirmationControl |
Obtiene el control de confirmación de fotos para este dispositivo de vídeo. |
| PrimaryUse |
Obtiene o establece el uso principal para el dispositivo. |
| RegionsOfInterestControl |
Obtiene las regiones de control de interés para este dispositivo de vídeo. |
| Roll |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración del rollo de la cámara. |
| SceneModeControl |
Obtiene el control de modo de escena para este dispositivo de vídeo. |
| Tilt |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración de inclinación de la cámara. |
| TorchControl |
Obtiene el control de antorcha para este dispositivo de vídeo. |
| VariablePhotoSequenceController |
Obtiene la variablePhotoSequenceController asociada con VideoDeviceController. |
| VideoTemporalDenoisingControl |
Obtiene el objeto VideoTemporalDenoisingControl asociado con VideoDeviceController. Esto permite habilitar y deshabilitar la desnodización temporal, que usa datos de imagen de fotogramas adyacentes para reducir la apariencia del ruido en el vídeo capturado, en los dispositivos que lo admiten. |
| WhiteBalance |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer el equilibrio de blancos en la cámara. |
| WhiteBalanceControl |
Obtiene el control de equilibrio de blancos para este dispositivo de vídeo. |
| Zoom |
Obtiene un objeto MediaDeviceControl que se puede usar para obtener o establecer la configuración de zoom de la cámara. |
| ZoomControl |
Obtiene el ZoomControl asociado a VideoDeviceController. |
Métodos
| GetAvailableMediaStreamProperties(MediaStreamType) |
Obtiene una lista de las propiedades de codificación admitidas para el dispositivo de vídeo. |
| GetDeviceProperty(String) |
Obtiene el valor de la propiedad con el identificador especificado del controlador de dispositivo de captura. Puede usar este método para consultar propiedades específicas de una cámara determinada. |
| GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>) |
Obtiene el valor de la propiedad con el identificador especificado del controlador de dispositivo de captura, utilizando un identificador extendido con información de encabezado personalizada y especificando el tamaño máximo del búfer necesario para almacenar el resultado. Puede usar este método para consultar propiedades específicas de una cámara determinada. |
| GetDevicePropertyById(String, IReference<UInt32>) |
Obtiene un valor de la propiedad del controlador de dispositivo de captura con el identificador con información de encabezado personalizada. Puede usar este método para consultar propiedades específicas de una cámara determinada. |
| GetMediaStreamProperties(MediaStreamType) |
Obtiene las propiedades de codificación para el tipo de secuencia multimedia especificado para el dispositivo de vídeo. |
| SetDeviceProperty(String, Object) |
Establece el valor de la propiedad con el identificador especificado en el controlador de dispositivo de captura. Puede usar este método para establecer propiedades específicas de una cámara determinada. |
| SetDevicePropertyByExtendedId(Byte[], Byte[]) |
Establece el valor de la propiedad con el identificador especificado del controlador de dispositivo de captura, utilizando un identificador extendido con información de encabezado personalizada y proporcionando el valor como una matriz de bytes. |
| SetDevicePropertyById(String, Object) |
Establece el valor de la propiedad con el identificador especificado del controlador de dispositivo de captura, utilizando un identificador extendido con información de encabezado personalizada y proporcionando el valor como un objeto. |
| SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) |
Establece las propiedades de codificación de forma asincrónica para el tipo de secuencia multimedia especificado para el dispositivo de vídeo. |
| TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode) |
Solicita el control exclusivo de la cámara con el identificador de dispositivo especificado. |
| TryGetPowerlineFrequency(PowerlineFrequency) |
Obtiene la frecuencia de la línea de alimentación local. |
| TrySetPowerlineFrequency(PowerlineFrequency) |
Establece la frecuencia de la línea de alimentación local. |