BufferMediaFrame 类

定义

命名空间:

Windows.Media.Capture.Frames

表示 来自 MediaFrameSource 的帧，该帧在 IBuffer 中提供数据。

public ref class BufferMediaFrame sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BufferMediaFrame final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BufferMediaFrame

Public NotInheritable Class BufferMediaFrame

继承

Object Platform::Object IInspectable BufferMediaFrame

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

通过访问从媒体帧源获取的 MediaFrameReference 对象的 BufferMediaFrame 属性，获取此类的实例。 MediaFrameReference 的 BufferMediaFrame 属性将始终为非 null。 对于其他帧类型（如 VideoMediaFrame）则不适用，如果缓冲区不包含 2D 图像数据或包含未知格式的数据，则为 null。

BufferMediaFrame 表示 1D 缓冲区。 如果管道返回的基础样本包含非连续数据，则系统使用 IMFMediaBuffer.Lock 将 2D 缓冲区复制到 1D 缓冲区中。 因此，建议对任意缓冲区（如主干或正文跟踪数据）使用 BufferMediaFrame，但对 2D 缓冲区使用 VideoMediaFrame 以避免额外的复制操作。

有关使用 MediaFrameSource 捕获帧的操作指南，请参阅 使用 MediaFrameReader 处理媒体帧。

属性

Buffer	获取包含 BufferMediaFrame 数据的缓冲区。
FrameReference	获取与 BufferMediaFrame 关联的 MediaFrameReference 包装器对象，该对象提供对媒体帧的格式信息和其他属性的访问。

另请参阅

• 使用 MediaFrameReader 处理媒体帧