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 取得的畫面格時，系統應該管理從 MultiSourceMediaFrameReader 取得的畫面。

方法

Close()	處置物件和相關聯的資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
StartAsync()	以非同步方式開始從一或多個 MediaFrameSource 物件讀取時間核心框架。
StopAsync()	以非同步方式停止從一或多個 MediaFrameSource 物件讀取時間核心框架。
TryAcquireLatestFrame()	嘗試取得 MultiSourceMediaFrameReference 物件，該物件可讓您從一或多個 MediaFrameSource 物件存取最新的時間相互關聯畫面。

事件

FrameArrived

當新的畫面從與 MultiSourceMediaFrameReader相關聯的所有媒體畫面來源送達時發生。