Метод ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) (d2d1.h)
Создает целевой объект отрисовки, который отрисовывается для точечного изображения компонента образов Microsoft Windows (WIC).
Синтаксис
HRESULT CreateWicBitmapRenderTarget(
[in] IWICBitmap *target,
[ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
[out] ID2D1RenderTarget **renderTarget
);
Параметры
[in] target
Тип: IWICBitmap*
Растровое изображение, получающее выходные данные отрисовки целевого объекта отрисовки.
[ref] 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 |