Share via


RenderTargetBitmap.GetPixelsAsync Méthode

Définition

Récupère l’image RenderTargetBitmap précédemment rendue sous la forme d’un flux d’octets mis en mémoire tampon au format alpha prémultiplié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)

Retours

Objet d’opération asynchrone à partir duquel, en cas d’achèvement réussi, vous pouvez récupérer un flux IBuffer qui contient des octets. Il s’agit des données binaires de l’image et peuvent être converties en tableau d’octets au format BGRA8

Attributs

Remarques

La valeur de retour IBuffer permet de transmettre le résultat à un WriteableBitmap et à son PixelBuffer. Une autre alternative consiste à passer la mémoire tampon à un BitmapEncoder. Si vous souhaitez un tableau d’octets, utilisez un DataReader et la méthode FromBuffer pour faciliter la conversion.

Par le biais de la valeur intermédiaire IAsyncOperation , cette méthode retourne les pixels de la source d’image qui a été produite par l’appel le plus récent à RenderAsync.

Appelez toujours RenderAsync avant d’appeler GetPixelsAsync. Si vous appelez GetPixelsAsync et que vous n’avez jamais appelé RenderAsync précédemment sur cette instance RenderTargetBitmap, GetPixelsAsync renverra un flux de mémoire tampon vide et aucune erreur ne se produira (l’état asynchrone étant Terminé, vous ne pouvez pas l’utiliser comme indicateur).

S’applique à

Voir aussi