VideoFrame 类

定义

命名空间:

Windows.Media

表示单个视频数据帧。

public ref class VideoFrame sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.IVideoFrameFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class VideoFrame final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.IVideoFrameFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VideoFrame : System.IDisposable

function VideoFrame(format, width, height, alpha)

Public NotInheritable Class VideoFrame
Implements IDisposable

继承

Object Platform::Object IInspectable VideoFrame

属性

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable IMediaFrame

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

版本历史记录

Windows 版本	SDK 版本	增值
1803	17134	CopyToAsync (VideoFrame，Nullable<BitmapBounds>，Nullable<BitmapBounds>)

构造函数

VideoFrame(BitmapPixelFormat, Int32, Int32)	初始化 VideoFrame 类的新实例。
VideoFrame(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	初始化 VideoFrame 类的新实例。

属性

Direct3DSurface	获取包含视频帧像素数据的 IDirect3DSurface 对象（如果存在）。
Duration	获取或设置视频帧的持续时间。
ExtendedProperties	获取扩展属性集，该属性集支持在媒体帧上获取和设置属性。
IsDiscontinuous	获取或设置一个值，该值指示视频帧是否为流中间隔后的第一帧。
IsReadOnly	获取一个值，该值指示视频帧是否为只读。
RelativeTime	获取或设置视频流中帧的相对时间。
SoftwareBitmap	获取 SoftwareBitmap 对象，该对象包含视频帧的像素数据（如果存在）。
SystemRelativeTime	获取或设置一个时间戳，该时间戳相对于系统，并且可在同一设备上跨多个媒体源进行更正。
Type	获取一个字符串，指示视频帧包含的视频数据类型。

方法

Close()	释放 对象和关联的资源。
CopyToAsync(VideoFrame)	将当前 VideoFrame 复制到提供的 VideoFrame 对象中。
CopyToAsync(VideoFrame, IReference<BitmapBounds>, IReference<BitmapBounds>)	将当前 VideoFrame 中的指定矩形复制到提供的 VideoFrame 对象的指定矩形中。
CreateAsDirect3D11SurfaceBacked(DirectXPixelFormat, Int32, Int32)	创建 VideoFrame 类的新实例，图像数据存储在默认 Direct3D 设备分配的 IDXGISurface 中。
CreateAsDirect3D11SurfaceBacked(DirectXPixelFormat, Int32, Int32, IDirect3DDevice)	创建 VideoFrame 类的新实例，图像数据存储在提供的 Direct3D 设备分配的 IDXGISurface 中。
CreateWithDirect3D11Surface(IDirect3DSurface)	创建 VideoFrame 类的新实例，图像数据存储在提供的 IDXGISurface 中。
CreateWithSoftwareBitmap(SoftwareBitmap)	从提供的 SoftwareBitmap 创建 VideoFrame 类的新实例。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。

另请参阅

• IMediaFrame
• IClosable