RenderTargetBitmap.GetPixelsAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
以前にレンダリングされた 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 に渡すことです。 バイト配列が必要な場合は、 DataReader メソッドと FromBuffer メソッドを使用して変換を支援します。
このメソッドは、 IAsyncOperation 中間値を使用して、 RenderAsync の最新の呼び出しによって生成されたイメージ ソースのピクセルを返します。
GetPixelsAsync を呼び出す前に、必ず RenderAsync を呼び出してください。 GetPixelsAsync を呼び出し、その RenderTargetBitmap インスタンスで RenderAsync を以前に呼び出したことがない場合、GetPixelsAsync は空のバッファー ストリームを返し、エラーは発生しません (非同期状態は完了です。そのため、インジケーターとして使用することはできません)。