ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**) (d2d1.h)
Crea un destino de representación que se representa en un mapa de bits de Microsoft Windows Imaging Component (WIC).
Sintaxis
HRESULT CreateWicBitmapRenderTarget(
[in] IWICBitmap *target,
[in] const D2D1_RENDER_TARGET_PROPERTIES *renderTargetProperties,
[out] ID2D1RenderTarget **renderTarget
);
Parámetros
[in] target
Tipo: IWICBitmap*
Mapa de bits que recibe la salida de representación del destino de representación.
[in] renderTargetProperties
Tipo: const D2D1_RENDER_TARGET_PROPERTIES*
El modo de representación, el formato de píxeles, las opciones de comunicación remota, la información de PPP y la compatibilidad mínima con DirectX que se necesita para la representación de hardware. Para obtener información sobre los formatos de píxeles admitidos, vea Formatos de píxeles admitidos y Modos alfa.
[out] renderTarget
Tipo: ID2D1RenderTarget**
Cuando este método finaliza, contiene la dirección del puntero al objeto ID2D1RenderTarget creado por este método.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .
Comentarios
Debe usar D2D1_FEATURE_LEVEL_DEFAULT para el miembro minLevel del parámetro renderTargetProperties con este método.
La aplicación debe crear destinos de representación una vez y mantenerlos durante la vida útil de la aplicación o hasta que se reciba el error D2DERR_RECREATE_TARGET . Cuando reciba este error, debe volver a crear el destino de representación (y los recursos que creó).
Nota
Este método no se admite en Windows Phone y se producirá un error cuando se llame en un dispositivo con código de error 0x8899000b ("No hay ningún dispositivo de representación de hardware disponible para esta operación"). Dado que el emulador de Windows Phone admite la representación WARP, este método producirá un error cuando se llame en el emulador con un código de error diferente, 0x88982f80 (wincodec_err_unsupportedpixelformat).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | d2d1.h |
| Library | D2d1.lib |
| Archivo DLL | D2d1.dll |