ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES*,ID2D1Bitmap**) (d2d1.h)

Crea un objeto ID2D1Bitmap copiando el mapa de bits de Componente de imágenes de Microsoft Windows (WIC) especificado.

Sintaxis

HRESULT CreateBitmapFromWicBitmap(
        IWICBitmapSource             *wicBitmapSource,
        const D2D1_BITMAP_PROPERTIES *bitmapProperties,
  [out] ID2D1Bitmap                  **bitmap
);

Parámetros

wicBitmapSource

Tipo: [in] IWICBitmapSource*

Mapa de bits WIC que se va a copiar.

bitmapProperties

Tipo: [in, opcional] const D2D1_BITMAP_PROPERTIES*

Formato de píxel y PPP del mapa de bits que se va a crear. El formato de píxel debe coincidir con el formato de píxel de wicBitmapSource o se producirá un error en el método. Para evitar un error de coincidencia, puede pasar NULL o pasar el valor obtenido al llamar a la función auxiliar D2D1::P ixelFormat sin especificar ningún valor de parámetro. Si pppX y pppY son 0,0f, se usa el valor predeterminado de PPP, 96. Se omite la información de PPP incrustada en wicBitmapSource .

[out] bitmap

Tipo: ID2D1Bitmap**

Cuando este método vuelve, contiene la dirección de un puntero al nuevo mapa de bits. Este parámetro se pasa sin inicializar.

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

Antes de que Direct2D pueda cargar un mapa de bits WIC, ese mapa de bits debe convertirse en un formato de píxeles y un modo alfa admitidos. Para obtener una lista de los formatos de píxeles admitidos y los modos alfa, consulte Formatos de píxeles admitidos y Modos alfa.

Ejemplos

Para obtener ejemplos, vea Cómo cargar un mapa de bits desde un archivo y Cómo cargar un mapa de bits desde un recurso.

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

Consulte también

Cómo cargar un mapa de bits desde un archivo

ID2D1Bitmap

ID2D1RenderTarget

Formatos de píxel admitidos y modos alfa