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 |