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


Метод ID2D1Bitmap1::GetSurface (d2d1_1.h)

Получает либо поверхность, указанную при создании растрового изображения, либо поверхность по умолчанию, созданную при создании растрового рисунка.

Синтаксис

HRESULT GetSurface(
  [out, optional] IDXGISurface **dxgiSurface
);

Параметры

[out, optional] dxgiSurface

Тип: IDXGISurface**

Базовая поверхность DXGI для растрового изображения.

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

Тип: HRESULT

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

HRESULT Описание:
S_OK Без ошибок.
D2DERR_BITMAP_BOUND_AS_TARGET Не удается рисовать с растровым рисунком, который в настоящее время привязан как целевой растровый рисунок.

Комментарии

Используемое растровое изображение должно быть создано из целевого объекта отрисовки поверхности DXGI, производного целевого объекта отрисовки или контекста устройства, созданного на основе ID2D1Device.

Возвращаемую поверхность можно использовать с Microsoft Direct3D или любым другим API, который взаимодействует с общими поверхностями. Приложение должно транзитивно гарантировать, что поверхность доступна для использования на устройстве Direct3D, используемом в этом контексте. Например, при использовании surface с Direct2D целевой объект отрисовки Direct2D должен быть создан с помощью ID2D1Factory::CreateDxgiSurfaceRenderTarget или в контексте устройства, созданном на том же устройстве.

Требования

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

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

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap