MultiSourceMediaFrameReader 类

定义

命名空间:

Windows.Media.Capture.Frames

提供对来自多个 MediaFrameSource 的时间相关帧的访问，并在新帧到达时提供通知。 如果需要处理来自不同源（如深度相机和 rbg 相机）的帧，并且需要确保每个源的帧在时间上彼此靠近地捕获，这非常有用。

public ref class MultiSourceMediaFrameReader sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MultiSourceMediaFrameReader final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MultiSourceMediaFrameReader : System.IDisposable

Public NotInheritable Class MultiSourceMediaFrameReader
Implements IDisposable

继承

Object Platform::Object IInspectable MultiSourceMediaFrameReader

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

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

若要从不同源之间没有时间关联的一个或多个 MediaFrameSource 对象读取帧，可以使用 MediaFrameReader。

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

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	AcquisitionMode

属性

AcquisitionMode

指定在应用完成处理前一帧之前，当新帧到达时，系统应管理从 MultiSourceMediaFrameReader 获取的帧的方式。

方法

Close()	释放 对象和关联的资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
StartAsync()	异步开始从一个或多个 MediaFrameSource 对象读取时间带时间的帧。
StopAsync()	异步停止从一个或多个 MediaFrameSource 对象读取时间核心帧。
TryAcquireLatestFrame()	尝试获取 MultiSourceMediaFrameReference 对象，该对象提供对一个或多个 MediaFrameSource 对象中与时间相关的最新帧的访问权限。

事件

FrameArrived

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