MediaCapture.GetPreviewFrameAsync 方法

定义

命名空间:

Windows.Media.Capture

重载

GetPreviewFrameAsync()	从捕获设备获取预览帧。
GetPreviewFrameAsync(VideoFrame)	从捕获设备获取预览帧，并将其复制到提供的目标 VideoFrame 并转换为目标帧的格式。

GetPreviewFrameAsync()

从捕获设备获取预览帧。

public:
 virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync() = GetPreviewFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync();

[Windows.Foundation.Metadata.Overload("GetPreviewFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync();

function getPreviewFrameAsync()

Public Function GetPreviewFrameAsync () As IAsyncOperation(Of VideoFrame)

返回

IAsyncOperation<VideoFrame>

成功完成时返回 VideoFrame 的异步操作。

属性

OverloadAttribute RemoteAsyncAttribute

Windows 要求

应用功能	backgroundMediaRecording

注解

此方法以捕获设备的当前格式返回预览帧，而无需复制或转换帧。 若要获取其他格式的预览帧，请使用 GetPreviewFrameAsync (VideoFrame) 重载并传入具有所需格式的 VideoFrame 。

有关预览帧的操作指南，请参阅 获取预览帧。

注意

对于需要按序列捕获大量帧的应用方案（例如计算机视觉方案），建议使用 MediaFrameReader 类而不是 GetPreviewFrameAsync。 有关详细信息和操作指南，请参阅 使用 MediaFrameReader 处理媒体帧。

另请参阅

• GetPreviewFrameAsync(VideoFrame)
• 获取预览帧

GetPreviewFrameAsync(VideoFrame)

从捕获设备获取预览帧，并将其复制到提供的目标 VideoFrame 并转换为目标帧的格式。

public:
 virtual IAsyncOperation<VideoFrame ^> ^ GetPreviewFrameAsync(VideoFrame ^ destination) = GetPreviewFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame const& destination);

[Windows.Foundation.Metadata.Overload("GetPreviewFrameCopyAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VideoFrame> GetPreviewFrameAsync(VideoFrame destination);

function getPreviewFrameAsync(destination)

Public Function GetPreviewFrameAsync (destination As VideoFrame) As IAsyncOperation(Of VideoFrame)

参数

destination

VideoFrame

将预览帧复制到的视频帧。

返回

IAsyncOperation<VideoFrame>

成功完成时返回 VideoFrame 的异步操作。

属性

OverloadAttribute RemoteAsyncAttribute

Windows 要求

应用功能	backgroundMediaRecording

注解

若要在不执行复制或转换操作的情况下获取预览帧，请使用 GetPreviewFrameAsync 的 no 参数重载。

有关预览帧的操作指南，请参阅 获取预览帧。

注意

对于需要按序列捕获大量帧的应用方案（例如计算机视觉方案），建议使用 MediaFrameReader 类而不是 GetPreviewFrameAsync。 有关详细信息和操作指南，请参阅 使用 MediaFrameReader 处理媒体帧。

另请参阅

• GetPreviewFrameAsync()
• 获取预览帧