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

Статья
08/22/2023

Создает растровое изображение из поверхности 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

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