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

  • Статья

Сопоставляет заданное растровое изображение с памятью.

Синтаксис

HRESULT Map(
        D2D1_MAP_OPTIONS options,
  [out] D2D1_MAPPED_RECT *mappedRect
);

Параметры

options

Тип: D2D1_MAP_OPTIONS

Параметры, используемые при сопоставлении растрового рисунка с памятью.

[out] mappedRect

Тип: D2D1_MAPPED_RECT*

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

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

Тип: HRESULT

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

HRESULT Описание:
S_OK Без ошибок.
E_INVALIDARG Один или несколько аргументов являются недопустимыми
D3DERR_DEVICELOST Устройство потеряно, но в настоящее время его невозможно сбросить.

Комментарии

Примечание При сопоставлении нельзя использовать растровые изображения для некоторых целей. В частности, метод ID2D1Bitmap::CopyFromBitmap не работает, если сопоставлено исходное или целевое растровое изображение.
 
Растровое изображение должно быть создано с указанным флагом D2D1_BITMAP_OPTIONS_CPU_READ .

Требования

   
Минимальная версия клиента 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