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

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

Sintaxis

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 de 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 valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT	Descripción
S_OK	No se ha producido ningún error.
E_OUTOFMEMORY	Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_INVALIDARG	Se pasó un parámetro no válido a la función de devolución.

Comentarios

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> se establece 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

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_1.h
Archivo DLL	D2d1.dll

Consulte también

ID2D1DeviceContext