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. Другой альтернативой является передача буфера в BitmapEncoder. Если требуется массив байтов, используйте DataReader и метод FromBuffer , чтобы упростить преобразование.

Через промежуточное значение IAsyncOperation этот метод возвращает пиксели источника изображения, созданного последним вызовом RenderAsync.

Всегда вызывайте RenderAsync перед вызовом GetPixelsAsync. Если вы вызываете Метод GetPixelsAsync и никогда ранее не вызывали RenderAsync в этом экземпляре RenderTargetBitmap , GetPixelsAsync вернет пустой буферный поток, и ошибка не возникнет (асинхронное состояниеCompleted, поэтому его нельзя использовать в качестве индикатора).

Применяется к

См. также раздел