RenderTargetBitmap.GetPixelsAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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).