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()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
StartAsync()	以非同步方式從 MediaFrameSource開始讀取畫面。
StopAsync()	以非同步方式停止從 MediaFrameSource讀取畫面。
TryAcquireLatestFrame()	嘗試從MediaFrameSource取得代表最新框架的MediaFrameReference物件。

事件

FrameArrived

當新的畫面從與 MediaFrameReader相關聯的媒體畫面來源抵達時發生。

另請參閱

• IClosable
• 使用 MediaFrameReader 處理媒體畫面