RenderTargetBitmap.GetPixelsAsync 方法

定义

检索以前呈现的 RenderTargetBitmap 图像作为 BGRA8 格式的缓冲字节流。

public:
 virtual IAsyncOperation<IBuffer ^> ^ GetPixelsAsync() = GetPixelsAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IBuffer> GetPixelsAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IBuffer> GetPixelsAsync();
function getPixelsAsync()
Public Function GetPixelsAsync () As IAsyncOperation(Of IBuffer)

返回

异步操作对象,成功完成后,可以从中检索包含字节的 IBuffer 流。 这是图像的二进制数据,可以转换为 BGRA8 格式的字节数组

属性

注解

IBuffer 返回值允许将结果传递给 WriteableBitmap 及其 PixelBuffer。 另一种替代方法是将缓冲区传递给 BitmapEncoder。 如果需要字节数组,请使用 DataReaderFromBuffer 方法来帮助转换。

通过 IAsyncOperation 中间值,此方法返回最近调用 RenderAsync 生成的图像源的像素。

始终在调用 GetPixelsAsync 之前调用 RenderAsync 。 如果调用 GetPixelsAsync,但以前从未在该 RenderTargetBitmap 实例上调用 RenderAsync,则 GetPixelsAsync 将返回空缓冲区流,并且不会在异步状态为“已完成 (发生错误,因此不能将其用作) 的指示器。

适用于

另请参阅