Compartilhar via


Método ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES&,ID2D1Bitmap**) (d2d1.h)

Cria um ID2D1Bitmap copiando o bitmap de WIC (Componente de Imagem do Microsoft Windows) especificado.

Sintaxe

HRESULT CreateBitmapFromWicBitmap(
  IWICBitmapSource               *wicBitmapSource,
  const D2D1_BITMAP_PROPERTIES & bitmapProperties,
  ID2D1Bitmap                    **bitmap
);

Parâmetros

wicBitmapSource

Tipo: [in] IWICBitmapSource*

O bitmap wic a ser copiado.

bitmapProperties

Tipo: [in] const D2D1_BITMAP_PROPERTIES &

O formato de pixel e a DPI do bitmap a ser criado. O formato de pixel deve corresponder ao formato de pixel de wicBitmapSource ou o método falhará. Para evitar uma incompatibilidade, você pode passar NULL ou passar o valor obtido de chamar a função auxiliar D2D1::P ixelFormat sem especificar nenhum valor de parâmetro. Se dpiX e dpiY forem 0,0f, o DPI padrão, 96, será usado. As informações de DPI inseridas em wicBitmapSource são ignoradas.

bitmap

Tipo: [out] ID2D1Bitmap**

Quando esse método retorna, contém o endereço de um ponteiro para o novo bitmap. Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Antes que Direct2D possa carregar um bitmap WIC, esse bitmap deve ser convertido em um formato de pixel e modo alfa com suporte. Para obter uma lista de formatos de pixel com suporte e modos alfa, consulte Formatos de pixel com suporte e modos alfa.

Exemplos

Para obter exemplos, consulte How to Load a Bitmap from a File and How to Load a Bitmap from a Resource.

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

Como carregar um bitmap de um arquivo

ID2D1Bitmap

ID2D1RenderTarget

Formatos de pixel e modos alfa com suporte