MediaFrameReader 类

定义

命名空间:

Windows.Media.Capture.Frames

提供对 MediaFrameSource 中的帧的访问，并在新帧到达时发出通知。

public ref class MediaFrameReader sealed : IClosable

/// [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 MediaFrameReader final : IClosable

[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 MediaFrameReader : System.IDisposable

Public NotInheritable Class MediaFrameReader
Implements IDisposable

继承

Object Platform::Object IInspectable MediaFrameReader

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

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

注解

通过在已初始化为使用所需媒体帧源的 MediaCapture 对象上调用 CreateFrameReaderAsync 来获取此类的实例。

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

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	AcquisitionMode

属性

AcquisitionMode

获取或设置一个值，该值指定在应用完成处理上一帧之前，当新帧到达时，系统应管理从 MediaFrameReader 获取的帧的方式。

方法

Close()	释放 对象和关联的资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
StartAsync()	从 MediaFrameSource 异步开始读取帧。
StopAsync()	异步停止从 MediaFrameSource 读取帧。
TryAcquireLatestFrame()	尝试从 MediaFrameSource 获取表示最新帧的 MediaFrameReference 对象。

事件

FrameArrived

当新帧从与 MediaFrameReader 关联的媒体帧源到达时发生。

另请参阅

• IClosable
• 使用 MediaFrameReader 处理媒体帧