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.

Retornar valor

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT	Descrição
S_OK	Não ocorreu nenhum erro.
E_OUTOFMEMORY	Direct2D não foi possível alocar memória suficiente para concluir a chamada.
E_INVALIDARG	Um parâmetro inválido foi passado para a função de retorno.

Comentários

Começando com Windows 8.1, o parâmetro bitmapProperties é opcional. Quando não é especificado, o bitmap criado herda o formato de pixel e o modo alfa de 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1_1.h
DLL	D2d1.dll

Confira também

ID2D1DeviceContext