Método ID2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Cria um bitmap Direct2D copiando um bitmap WIC.

Sintaxe

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

Parâmetros

[in] wicBitmapSource

Tipo: IWICBitmapSource*

A origem do bitmap wic da qual copiar.

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Uma estrutura de propriedades de bitmap que especifica opções de criação de bitmap.

[out] bitmap

Tipo: ID2D1Bitmap1**

O endereço do objeto bitmap recém-criado.

Valor de retorno

Tipo: HRESULT

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Observações

A partir do Windows 8.1, o parâmetro bitmapProperties é opcional. Quando não for especificado, o bitmap criado herdará o formato de pixel e o modo alfa do wicBitmapSource. Para obter uma lista de formatos de pixel com suporte e modos alfa, consulte formatos de pixel com suporte e modos alfa.

Quando o parâmetro bitmapProperties é especificado, o valor em bitmapProperties-pixelFormat> deve ser DXGI_FORMAT_UNKNOWN ou deve corresponder ao formato de pixel WIC em wicBitmapSource.

Quando bitmapProperties-pixelFormat.alphaMode> é definido como D2D1_ALPHA_MODE_UNKNOWN, o bitmap recém-criado herda o modo alfa de wicBitmapSource. Quando bitmapProperties-pixelFormat.alphaMode> é definido como D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT ou D2D1_ALPHA_MODE_IGNORE, isso força o bitmap recém-criado a usar o modo alfa especificado.

Requirements

Consulte também

ID2D1DeviceContext