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 |