VideoDeviceController 类

定义

命名空间:

Windows.Media.Devices

控制相机上的设备设置。

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 VideoDeviceController

Public NotInheritable Class VideoDeviceController

继承

Object Platform::Object IInspectable VideoDeviceController

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMediaDeviceController

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

若要获取此对象的实例，请检索 MediaCapture.VideoDeviceController 属性。

某些驱动程序可能要求相机设备预览处于运行状态，然后才能确定 VideoDeviceController 支持哪些控件。 如果在预览流运行之前检查 VideoDeviceController 是否支持某个控件，则即使视频设备支持该控件，该控件也可能被描述为不受支持。

注意

此类不敏捷，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅线程和封送处理 (C++/CX) 和使用多线程环境中的Windows 运行时对象 (.NET) 。

版本历史记录

Windows 版本	SDK 版本	已添加值
1703	15063	GetDevicePropertyByExtendedId
1703	15063	GetDevicePropertyById
1703	15063	ID
1703	15063	SetDevicePropertyByExtendedId
1703	15063	SetDevicePropertyById
1803	17134	VideoTemporalDenoisingControl
1903	18362	InfraredTorchControl
2004	19041	PanelBasedOptimizationControl

属性

AdvancedPhotoControl	获取此视频设备的高级照片捕获控件。
BacklightCompensation	获取一个 MediaDeviceControl 对象，该对象可用于获取或设置是否在相机上启用了反光补偿。
Brightness	获取可用于获取或设置相机亮度级别的 MediaDeviceControl 对象。
CameraOcclusionInfo	获取 CameraOcclusionInfo 对象，该对象可用于获取相机的当前遮挡状态，并在遮挡状态更改时接收通知。
Contrast	获取一个 MediaDeviceControl 对象，该对象可用于获取或设置相机上的对比度级别。
DesiredOptimization	获取或设置一个值，该值指示捕获设备在视频捕获期间确定高质量图片、低延迟或低功耗的优先级时应使用的优化。
DigitalWindowControl	获取 一个 DigitalWindowControl ，它允许应用捕获捕获设备传感器的子区域。
Exposure	获取可用于获取或设置相机曝光时间的 MediaDeviceControl 对象。
ExposureCompensationControl	获取此视频设备的曝光补偿控件。
ExposureControl	获取此视频设备的曝光控件。
ExposurePriorityVideoControl	获取与 VideoDeviceController 关联的 ExposurePriorityVideoControl。
FlashControl	获取此视频设备的闪光灯控件。
Focus	获取可用于获取或设置相机焦点设置的 MediaDeviceControl 对象。
FocusControl	获取此视频设备的焦点控件。
HdrVideoControl	获取与 VideoDeviceController 关联的 HdrVideoControl。 这样，就可以在支持高动态范围 (HDR) 视频捕获模式的设备上启用和禁用。
Hue	获取一个 MediaDeviceControl 对象，该对象可用于获取或设置相机的色调设置。
Id	获取一个字符串，其中包含视频设备控制器的标识符。
InfraredTorchControl	获取所选视频设备的红外火炬控件。
IsoSpeedControl	获取此视频设备的 ISO 胶片速度控制。
LowLagPhoto	获取此视频设备的低快门延迟照片控件。
LowLagPhotoSequence	获取此视频设备的低快门延迟照片序列控件。
OpticalImageStabilizationControl	获取与 VideoDeviceController 关联的 OpticalImageStabilizationControl。
Pan	获取可用于获取或设置相机的平移设置的 MediaDeviceControl 对象。
PanelBasedOptimizationControl	获取 PanelBasedOptimizationControl ，如果受支持，则允许应用启用捕获设备驱动程序，以便根据相机的面板位置优化相机捕获功能。
PhotoConfirmationControl	获取此视频设备的照片确认控件。
PrimaryUse	获取或设置设备的主要用途。
RegionsOfInterestControl	获取此视频设备的感兴趣区域控制。
Roll	获取可用于获取或设置相机的滚动设置的 MediaDeviceControl 对象。
SceneModeControl	获取此视频设备的场景模式控件。
Tilt	获取可用于获取或设置相机倾斜设置的 MediaDeviceControl 对象。
TorchControl	获取此视频设备的火炬控件。
VariablePhotoSequenceController	获取与 VideoDeviceController 关联的 VariablePhotoSequenceController。
VideoTemporalDenoisingControl	获取与 VideoDeviceController 关联的VideoTemporalDenoisingControl。 这样，就可以在支持它的设备上启用和禁用临时降噪，它使用相邻帧中的图像数据来减少捕获的视频中的噪音外观。
WhiteBalance	获取一个 MediaDeviceControl 对象，该对象可用于获取或设置相机上的白平衡。
WhiteBalanceControl	获取此视频设备的白平衡控件。
Zoom	获取一个 MediaDeviceControl 对象，该对象可用于获取或设置相机的缩放设置。
ZoomControl	获取与 VideoDeviceController 关联的 ZoomControl。

方法

GetAvailableMediaStreamProperties(MediaStreamType)	获取视频设备支持的编码属性的列表。
GetDeviceProperty(String)	从捕获设备驱动程序获取具有指定 ID 的 属性的值。 可以使用此方法查询特定于特定相机的属性。
GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>)	从捕获设备驱动程序获取具有指定 ID 的 属性的值，使用具有自定义标头信息的扩展 ID 并指定存储结果所需的最大缓冲区大小。 可以使用此方法查询特定于特定相机的属性。
GetDevicePropertyById(String, IReference<UInt32>)	使用具有自定义标头信息的 ID 从捕获设备驱动程序获取 属性的值。 可以使用此方法查询特定于特定相机的属性。
GetMediaStreamProperties(MediaStreamType)	获取视频设备的指定媒体流类型的编码属性。
SetDeviceProperty(String, Object)	使用捕获设备驱动程序上的指定 ID 设置 属性的值。 可以使用此方法设置特定于特定相机的属性。
SetDevicePropertyByExtendedId(Byte[], Byte[])	使用捕获设备驱动程序中的指定 ID 设置 属性的值，使用具有自定义标头信息的扩展 ID，并将该值作为字节数组提供。
SetDevicePropertyById(String, Object)	使用捕获设备驱动程序中的指定 ID 设置 属性的值，使用具有自定义标头信息的扩展 ID，并将值作为对象提供。
SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)	为视频设备的指定媒体流类型异步设置编码属性。
TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode)	请求对具有指定设备 ID 的相机进行独占控制。
TryGetPowerlineFrequency(PowerlineFrequency)	获取本地电源线频率。
TrySetPowerlineFrequency(PowerlineFrequency)	设置本地电源线频率。

另请参阅

• 灯设备示例