Compartilhar via


RenderTargetBitmap.GetPixelsAsync Método

Definição

Recupera a imagem RenderTargetBitmap renderizada anteriormente como um fluxo em buffer de bytes no formato alfa BGRA8, pré-multiplicado.

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)

Retornos

Um objeto de operação assíncrono do qual, após a conclusão bem-sucedida, você pode recuperar um fluxo IBuffer que contém bytes. Esses são os dados binários da imagem e podem ser convertidos em uma matriz de bytes no formato BGRA8

Atributos

Comentários

O valor retornado do IBuffer permite passar o resultado para um WriteableBitmap e seu PixelBuffer. Outra alternativa é passar o buffer para um BitmapEncoder. Se você quiser uma matriz de bytes, use um DataReader e o método FromBuffer para ajudar na conversão.

Por meio do valor intermediário IAsyncOperation , esse método retorna os pixels da fonte de imagem que foi produzida pela chamada mais recente para RenderAsync.

Sempre chame RenderAsync antes de chamar GetPixelsAsync. Se você chamar GetPixelsAsync e nunca tiver chamado RenderAsync anteriormente naquela instância do RenderTargetBitmap , GetPixelsAsync retornará um fluxo de buffer vazio e nenhum erro ocorrerá (o Status assíncrono é Concluído, portanto, você não pode usá-lo como um indicador).

Aplica-se a

Confira também