Поделиться через

Метод ID2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

  • Статья

Создает растровое изображение из поверхности DXGI, которое можно задать в качестве целевой поверхности или указать дополнительные сведения о контексте цвета.

Синтаксис

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                  *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Параметры

[in] surface

Тип: IDXGISurface*

Поверхность DXGI, из которой можно создать растровое изображение.

Примечание Поверхность DXGI должна быть создана на том же устройстве Direct3D, с которым связан контекст устройства Direct2D.
 

[in, optional] bitmapProperties

Тип: const D2D1_BITMAP_PROPERTIES1*

Свойства растрового изображения, указанные в дополнение к поверхности.

[out] bitmap

Тип: ID2D1Bitmap1**

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

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

Тип: HRESULT

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

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

Комментарии

Если свойства растрового рисунка не указаны, предполагается следующее:

  • DPI растрового изображения — 96.
  • Формат пикселей соответствует формату поверхности.
  • Возвращаемое растровое изображение наследует флаги привязки поверхности DXGI.
    • Однако наследуется только подмножество флагов, значимых для Direct2D. Например, D3D10_USAGE_DYNAMIC несовместима с общедоступными флагами Direct2D.
  • Контекст цвета неизвестен.
  • Альфа-режим растрового рисунка будет предварительно замедленным (обычно) или прямым (A8).
Если указаны свойства растрового рисунка, свойства растрового рисунка будут использоваться следующим образом:
  • DPI растрового рисунка будет задан свойствами растрового изображения.
  • Если и dpiX, и dpiY имеют значение 0, то точечный рисунок будет иметь значение 96.
  • Формат пикселей должен быть совместим с представлением ресурсов шейдера или целевым представлением отрисовки поверхности.
  • Параметры растрового изображения должны быть совместимы с флагами привязки поверхности DXGI. Однако они могут быть подмножеством. Это будет влиять на то, какие представления ресурсов создаются растровым изображением.
  • Сведения о контексте цвета будут использоваться из свойств растрового изображения, если они указаны.

Требования

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

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

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget