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 處理媒體畫面