VideoMediaFrame 類別

定義

命名空間:

Windows.Media.Capture.Frames

代表 來自 MediaFrameSource 的框架，提供 IDirect3DSurface 或 SoftwareBitmap所代表之視訊畫面中的資料。

public ref class VideoMediaFrame 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 VideoMediaFrame 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 VideoMediaFrame

Public NotInheritable Class VideoMediaFrame

繼承

Object Platform::Object IInspectable VideoMediaFrame

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

藉由存取從媒體畫面來源取得之MediaFrameReference物件的VideoMediaFrame屬性，以取得這個類別的實例。

重要

如果您要存取 MediaFrameReference 的 VideoMediaFrame 屬性提供的 SoftwareBitmap 或 Direct3DSurface 物件，則系統會建立這些物件的強式參考，這表示當您在包含的 MediaFrameReference 上呼叫 Dispose 時，他們不會被處置。 您必須針對要立即處置的物件明確地直接呼叫 SoftwareBitmap 或 Direct3DSurface 的 Dispose 方法。 否則，記憶體回收行程最終會釋放這些物件的記憶體，但您無法得知何時會釋放，而且如果配置的點陣圖或表面的數量超過系統允許的數量上限，新畫面的資料流就會停止。 在該相同想法中，如果您已呼叫 (GetVideoFrame () ) [videomediaframe_getvideoframe_824740069.md]，則 (VideoFrame) [..已擷取的 /windows.media/videoframe.md] 在 VideoMediaFrame 提供的 SoftwareBitmap 或 Direct3DSurface 物件上具有參考，而且必須手動呼叫其 Dispose 方法來處置 ，以避免封鎖畫面的 fow。 如果您想要保留透過 (GetVideoFrame () ) [videomediaframe_getvideoframe_824740069.md] 擷取的 VideoFrame 一段時間，最好改為保留它的複本。

如需使用 MediaFrameSource 擷取畫面的作法指引，請參閱 使用 MediaFrameReader 處理媒體畫面。

屬性

CameraIntrinsics	取得 物件，描述產生 VideoMediaFrame之相機的失真模型。
DepthMediaFrame	如果框架包含深度資料，則取得DepthMediaFrame，其中包含 VideoMediaFrame的深度資料。
Direct3DSurface	取得 IDirect3DSurface 物件，其中包含 VideoMediaFrame的影像資料。
FrameReference	取得與VideoMediaFrame相關聯的MediaFrameReference包裝函式物件，這個物件可讓您存取媒體框架的格式資訊和其他屬性。
InfraredMediaFrame	如果框架包含基礎結構資料，則取得包含 VideoMediaFrame 深度資料的 InfraredMediaFrame。
SoftwareBitmap	取得 SoftwareBitmap 物件，其中包含 VideoMediaFrame的影像資料。
VideoFormat	取得 物件，描述 VideoMediaFrame 影像資料的格式。

方法

GetVideoFrame()

建立 VideoMediaFrame 複本做為 VideoFrame 物件。

另請參閱

• 使用 MediaFrameReader 處理媒體畫面