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

Метод 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 недостаточно памяти дисплея для выполнения операции.

Комментарии

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

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