Freigeben über


RenderTargetBitmap.GetPixelsAsync Methode

Definition

Ruft das zuvor gerenderte RenderTargetBitmap-Bild als gepufferten Bytestrom im prämultiplizierten AlphaformatBGRA8 ab.

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)

Gibt zurück

Ein asynchrones Vorgangsobjekt, aus dem Sie bei erfolgreicher Fertigstellung einen IBuffer-Stream abrufen können, der Bytes enthält. Dies sind die Binärdaten für das Bild und können in ein Bytearray im BGRA8-Format konvertiert werden.

Attribute

Hinweise

Der IBuffer-Rückgabewert ermöglicht die Übergabe des Ergebnisses an eine WriteableBitmap und dessen PixelBuffer. Eine weitere Alternative besteht darin, den Puffer an einen BitmapEncoder zu übergeben. Wenn Sie ein Bytearray benötigen, verwenden Sie einen DataReader und die FromBuffer-Methode , um die Konvertierung zu unterstützen.

Über den IAsyncOperation-Zwischenwert gibt diese Methode die Pixel der Bildquelle zurück, die durch den letzten Aufruf von RenderAsync erzeugt wurde.

Rufen Sie immer RenderAsync auf, bevor Sie GetPixelsAsync aufrufen. Wenn Sie GetPixelsAsync aufrufen und RenderAsync nie zuvor für diese RenderTargetBitmap-instance aufgerufen haben, gibt GetPixelsAsync einen leeren Pufferdatenstrom zurück, und es tritt kein Fehler auf (der asynchrone Status ist Abgeschlossen, sodass Sie ihn nicht als Indikator verwenden können).

Gilt für:

Weitere Informationen