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 に結果を渡すことが可能になります。 もう 1 つの方法は、バッファーを BitmapEncoder に渡すことです。 バイト配列が必要な場合は、 DataReaderFromBuffer メソッドを使用して変換を支援します。

このメソッドは、 IAsyncOperation 中間値を使用して、 RenderAsync の最新の呼び出しによって生成されたイメージ ソースのピクセルを返します。

GetPixelsAsync を呼び出す前に、必ず RenderAsync を呼び出してください。 GetPixelsAsync を呼び出し、その RenderTargetBitmap インスタンスで RenderAsync を以前に呼び出したことがない場合、GetPixelsAsync は空のバッファー ストリームを返し、エラーは発生しません (非同期状態完了であるため、インジケーターとして使用することはできません)。

適用対象

こちらもご覧ください