Метод ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**) (d2d1.h)

  • Статья

Создает целевой объект отрисовки, который отрисовывается для точечного изображения компонента образов Microsoft Windows (WIC).

Синтаксис

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                          *target,
  [in]  const D2D1_RENDER_TARGET_PROPERTIES *renderTargetProperties,
  [out] ID2D1RenderTarget                   **renderTarget
);

Параметры

[in] target

Тип: IWICBitmap*

Растровое изображение, получающее выходные данные отрисовки целевого объекта отрисовки.

[in] renderTargetProperties

Тип: const D2D1_RENDER_TARGET_PROPERTIES*

Режим отрисовки, формат пикселей, параметры удаленного взаимодействия, сведения о DPI и минимальная поддержка DirectX, необходимая для аппаратной отрисовки. Сведения о поддерживаемых форматах пикселей см. в разделах Поддерживаемые форматы пикселей и Альфа-режимы.

[out] renderTarget

Тип: ID2D1RenderTarget**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

В этом методе необходимо использовать D2D1_FEATURE_LEVEL_DEFAULT для элемента minLevel параметра renderTargetProperties .

Приложение должно создать целевые объекты отрисовки один раз и удерживать их в течение всего времени существования приложения или до получения ошибки D2DERR_RECREATE_TARGET . При возникновении этой ошибки необходимо повторно создать целевой объект отрисовки (и все созданные ресурсы).

Примечание

Этот метод не поддерживается в Windows Phone и завершается сбоем при вызове на устройстве с кодом ошибки 0x8899000b ("Для этой операции отсутствует аппаратное устройство отрисовки"). Так как эмулятор Windows Phone поддерживает отрисовку WARP, этот метод завершится ошибкой при вызове в эмуляторе с другим кодом ошибки, 0x88982f80 (wincodec_err_unsupportedpixelformat).

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

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

ID2D1Factory