Compartilhar via

Método ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) (d2d1_1.h)

  • Artigo

Cria um bitmap que pode ser usado como uma superfície de destino, para ler de volta para a CPU ou como uma fonte para as APIs DrawBitmap e ID2D1BitmapBrush . Além disso, as informações de contexto de cor podem ser passadas para o bitmap.

Sintaxe

HRESULT CreateBitmap(
                 D2D1_SIZE_U                     size,
  [in, optional] const void                      *sourceData,
                 UINT32                          pitch,
  [in]           const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parâmetros

size

Tipo: D2D1_SIZE_U

O tamanho do pixel do bitmap a ser criado.

[in, optional] sourceData

Tipo: const void*

Os dados iniciais que serão carregados no bitmap.

pitch

Tipo: UINT32

O tom dos dados de origem, se especificado.

[in] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

As propriedades do bitmap a ser criado.

[out] bitmap

Tipo: ID2D1Bitmap1**

Quando esse método retorna, contém o endereço de um ponteiro para um novo objeto bitmap.

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 valor inválido foi passado para o método .
D3DERR_OUTOFVIDEOMEMORY O Direct3D não tem memória de exibição suficiente para executar a operação.

Comentários

O novo bitmap poderá ser usado como um destino para SetTarget se ele for criado com D2D1_BITMAP_OPTIONS_TARGET.

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

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext