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, поэтому его нельзя использовать в качестве индикатора).