Метод ID2D1Bitmap::CopyFromMemory (d2d1.h)

  • Статья

Копирует указанную область из памяти в текущее растровое изображение.

Синтаксис

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

Параметры

[in, optional] dstRect

Тип: const D2D1_RECT_U*

На текущем растровом рисунке — прямоугольник, в который копируется область, указанная srcRect .

[in] srcData

Тип: const void*

Копируемые данные.

pitch

Тип: UINT32

Шаг или шаг исходного растрового изображения, хранящегося в srcData. Шаг — это количество байтов линии сканирования (одна строка пикселей в памяти). Шаг можно вычислить по следующей формуле: ширина пикселя * байт на пиксель + заполнение памяти.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не обновляет размер текущего растрового изображения. Если содержимое исходного растрового рисунка не помещается в текущее растровое изображение, этот метод завершается ошибкой. Кроме того, обратите внимание, что этот метод не выполняет преобразование формата. форматы двух растровых рисунков должны совпадать.

Если этот метод передает недопустимые входные данные (например, недопустимый прямоугольник назначения), может привести к непредсказуемым результатам, таким как искаженное изображение или сбой устройства.

Вызов этого метода может привести к очистке текущего пакета, если растровое изображение активно в пакете. Если пакет, который был удален, не завершается успешно, этот метод завершается ошибкой. Однако этот метод не очищает состояние ошибки целевого объекта отрисовки, в котором был снят пакет. Состояние неработоспособности HRESULT и тега будут возвращены при следующем вызове Метода EndDraw или Flush.

Начиная с Windows 8.1 этот метод поддерживает блочные растровые изображения. Если используется формат со сжатием блока, конечные координаты параметра srcRect должны быть кратны 4, иначе метод возвращает E_INVALIDARG.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

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

ID2D1Bitmap