Метод 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 |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по