Id2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Crea un mapa de bits de Direct2D copiando un mapa de bits WIC.

Syntax

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Parámetros

[in] wicBitmapSource

Tipo: IWICBitmapSource*

Origen del mapa de bits WIC desde el que se va a copiar.

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Estructura de propiedades de mapa de bits que especifica las opciones de creación del mapa de bits.

[out] bitmap

Tipo: ID2D1Bitmap1**

Dirección del objeto de mapa de bits recién creado.

Valor devuelto

Tipo: HRESULT

El método devuelve un HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

Observaciones

A partir de Windows 8.1, el parámetro bitmapProperties es opcional. Cuando no se especifica, el mapa de bits creado hereda el formato de píxel y el modo alfa de wicBitmapSource. Para obtener una lista de los formatos de píxeles admitidos y los modos alfa, consulte Formatos de píxeles admitidos y Modos alfa.

Cuando se especifica el parámetro bitmapProperties, el valor de bitmapProperties-pixelFormat> debe ser DXGI_FORMAT_UNKNOWN o debe coincidir con el formato de píxel WIC en wicBitmapSource.

Cuando bitmapProperties-pixelFormat.alphaMode> está establecido en D2D1_ALPHA_MODE_UNKNOWN, el mapa de bits recién creado hereda el modo alfa de wicBitmapSource. Cuando bitmapProperties-pixelFormat.alphaMode> se establece en D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT o D2D1_ALPHA_MODE_IGNORE, esto obliga al mapa de bits recién creado a usar el modo alfa especificado.

Requisitos

Consulte también

ID2D1DeviceContext