VideoEncodingProperties 类

定义

命名空间:

Windows.Media.MediaProperties

描述视频流的编码属性。

public ref class VideoEncodingProperties 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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class VideoEncodingProperties 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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VideoEncodingProperties

function VideoEncodingProperties()

Public NotInheritable Class VideoEncodingProperties

继承

Object Platform::Object IInspectable VideoEncodingProperties

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMediaEncodingProperties

Windows 要求

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

注解

对于从以下预设编码配置文件之一创建的 VideoEncodingProperties ，将忽略手动设置的属性： CreateH264 和 CreateMpeg2。

编码质量 “自动 ”是一种特殊的预设，可根据当前相机设置填充正确的设置。 将忽略手动修改的设置。 例如，如果使用静态创建方法（如 CreateM4a）创建预设配置文件，并将 “自动 ”指定为编码质量，则对属性所做的任何更改都将根据当前相机设置的值覆盖。

注意

可以创建特定设备上不支持的 VideoEncodingProperties 。 例如，可以成功调用 CreateH264，但如果设备上不存在 h264 编码器，则尝试使用此方法返回的属性对视频进行编码将失败。 有关每个设备系列默认存在的编解码器的列表，请参阅 支持的编解码器。

有关为捕获的视频设置编码属性的操作指南，请参阅 使用 MediaCapture 捕获基本的照片、视频和音频。

版本历史记录

Windows 版本	SDK 版本	增值
1607	14393	StereoscopicVideoPackingMode
1703	15063	CreateHevc
1703	15063	SphericalVideoFrameFormat
1803	17134	复制

构造函数

VideoEncodingProperties()

创建 VideoEncodingProperties 类的新实例。

属性

Bitrate	获取或设置视频比特率。
FrameRate	获取或设置视频帧速率。
Height	获取或设置视频图像高度。
PixelAspectRatio	获取或设置像素纵横比。
ProfileId	获取或设置媒体格式配置文件。
Properties	获取视频流的其他格式属性。
SphericalVideoFrameFormat	获取一个值，该值指定视频帧的球面视频格式。
StereoscopicVideoPackingMode	获取一个值，该值指示视频流的立体视频打包模式。
Subtype	获取或设置格式的子类型。
Type	获取格式类型。
Width	获取或设置视频图像宽度。

方法

Copy()	创建 VideoEncodingProperties 对象的副本。
CreateAv1()	为 AOMedia Video 1 (AV1) 视频创建 VideoEncodingProperties 实例。
CreateH264()	为 H.264 视频创建 VideoEncodingProperties 的实例。
CreateHevc()	创建 VideoEncodingProperties 的实例，用于高效视频编码 (HEVC) 。
CreateMpeg2()	为 MPEG-2 视频创建 VideoEncodingProperties 的实例。
CreateUncompressed(String, UInt32, UInt32)	为未压缩的视频创建 VideoEncodingProperties 的实例。
CreateVp9()	为 VP9 视频创建 VideoEncodingProperties 的实例。
GetFormatUserData(Byte[])	获取媒体格式用户数据。
SetFormatUserData(Byte[])	设置媒体格式用户数据。

另请参阅

• 使用 MediaCapture 捕获基本的照片、视频和音频