Метод ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

  • Статья

Создает растровое изображение, которое можно использовать в качестве целевой поверхности, для чтения в ЦП или в качестве источника для API DrawBitmap и ID2D1BitmapBrush . Кроме того, в растровое изображение можно передать сведения о контексте цвета.

Синтаксис

HRESULT CreateBitmap(
                 D2D1_SIZE_U                   size,
  [in, optional] const void                    *sourceData,
                 UINT32                        pitch,
  [in, ref]      const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Параметры

size

Тип: D2D1_SIZE_U

Размер создаваемого растрового изображения в пикселях.

[in, optional] sourceData

Тип: const void*

Исходные данные, которые будут загружены в растровое изображение.

pitch

Тип: UINT32

Шаг исходных данных, если он указан.

[in, ref] bitmapProperties

Тип: const D2D1_BITMAP_PROPERTIES1

Свойства создаваемого растрового рисунка.

[out] bitmap

Тип: ID2D1Bitmap1**

При возврате этим методом содержит адрес указателя на новый объект растрового изображения.

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

Тип: HRESULT

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

HRESULT Описание:
S_OK Без ошибок.
E_OUTOFMEMORY Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG В метод было передано недопустимое значение.
D3DERR_OUTOFVIDEOMEMORY У Direct3D недостаточно памяти для выполнения операции.

Комментарии

Новое растровое изображение можно использовать в качестве целевого объекта для SetTarget , если оно создано с помощью D2D1_BITMAP_OPTIONS_TARGET.

Требования

   
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1_1.h
DLL D2d1.dll

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

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext