MediaCaptureVideoProfile 类

  • 参考

定义

命名空间:
Windows.Media.Capture
编辑

表示指示视频捕获设备支持的配置的视频配置文件。

public ref class MediaCaptureVideoProfile sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaCaptureVideoProfile final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
继承
Object Platform::Object IInspectable MediaCaptureVideoProfile
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

注解

视频配置文件提供了一种简单的方法来配置视频捕获设备，其中包含一组保证适用于特定捕获设备的设置，并针对所需的捕获方案进行优化。 系统为常见方案提供了一组已知的视频配置文件，例如捕获高质量照片或视频、捕获照片序列或视频会议。 若要获取给定视频设备的已知视频配置文件列表，请使用 MediaCapture.FindKnownVideoProfiles。 某些硬件供应商可能会公开可以通过调用 MediaCapture.FindAllVideoProfiles 获取的其他视频配置文件。

视频配置文件公开 MediaCaptureVideoProfileMediaDescription 对象、 SupportedPhotoMediaDescription、 SupportedPreviewMediaDescription 和 SupportedRecordMediaDescription 的三个列表。 这些列表中的每一项都是相应操作支持的一组设置。 例如，单个视频配置文件可能支持使用 HDR 视频支持以 30 fps 录制 720p 视频，还支持在没有 HDR 视频支持的情况下以 30 fps 录制 1080p 视频。 在这种情况下，其中每个对象都将由视频配置文件的 SupportedRecordMediaDescription 列表中的 MediaCaptureVideoProfileMediaDescription 对象表示。

使用 MediaCaptureInitializationSettings 对象将捕获设备配置为使用特定视频配置文件。 配置设备时使用的视频配置文件与其他初始化设置兼容非常重要。 有关如何在 MediaCaptureInitializationSettings 中正确使用媒体配置文件说明的详细信息，请参阅 MediaCaptureInitializationSettings.VideoProfile。

在使用视频配置文件之前，应检查 MediaCapture.IsVideoProfileSupported 返回的值，以确保捕获设备支持视频配置文件。

有关使用视频配置文件的操作指南，请参阅 使用相机配置文件发现和选择相机功能。

版本历史记录

Windows 版本 SDK 版本 增值
1803 17134 FrameSourceInfos
1803 17134 属性

属性

FrameSourceInfos

获取 MediaFrameSourceInfo 对象的只读列表，这些对象提供有关 MediaFrameSource 的功能的详细信息。
Id

获取视频配置文件的唯一标识符。
Properties

获取捕获设备制造商提供的自定义属性的只读映射。
SupportedPhotoMediaDescription

获取 MediaCaptureVideoProfileMediaDescription 对象的列表，这些对象表示照片捕获支持的视频设备设置。
SupportedPreviewMediaDescription

获取 MediaCaptureVideoProfileMediaDescription 对象的列表，这些对象表示视频预览支持的视频设备设置。
SupportedRecordMediaDescription

获取 MediaCaptureVideoProfileMediaDescription 对象的列表，这些对象表示视频录制支持的视频设备设置。
VideoDeviceId

获取与视频配置文件关联的视频设备的设备 ID。

方法

GetConcurrency()

获取可与此视频配置文件并发使用的 MediaCaptureVideoProfile 对象的列表。

适用于

另请参阅