Método ID2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Cria um bitmap de uma superfície DXGI que pode ser definida como uma superfície de destino ou ter informações adicionais de contexto de cor especificadas.

Sintaxe

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                  *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Parâmetros

[in] surface

Tipo: IDXGISurface*

A superfície DXGI da qual o bitmap pode ser criado.

Nota A superfície DXGI deve ter sido criada do mesmo dispositivo Direct3D ao qual o Direct2D contexto do dispositivo está associado.
 

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

As propriedades de bitmap especificadas além da superfície.

[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 pôde 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

Se as propriedades de bitmap não forem especificadas, as seguintes informações serão assumidas:

  • O DPI de bitmap é 96.
  • O formato de pixel corresponde ao da superfície.
  • O bitmap retornado herdará os sinalizadores de associação da superfície DXGI.
    • No entanto, somente o subconjunto de sinalizadores significativos para Direct2D será herdado. Por exemplo, D3D10_USAGE_DYNAMIC não é compatível com nenhum sinalizador de Direct2D público.
  • O contexto de cor é desconhecido.
  • O modo alfa do bitmap será pré-multiplicado (caso comum) ou reto (A8).
Se as propriedades de bitmap forem especificadas, as propriedades de bitmap serão usadas da seguinte maneira:
  • O DPI de bitmap será especificado pelas propriedades de bitmap.
  • Se dpiX e dpiY forem 0, o DPI de bitmap será 96.
  • O formato de pixel deve ser compatível com o modo de exibição de recurso de sombreador ou renderizar a exibição de destino da superfície.
  • As opções de bitmap devem ser compatíveis com os sinalizadores de associação da superfície DXGI. No entanto, eles podem ser um subconjunto. Isso influenciará quais exibições de recursos são criadas pelo bitmap.
  • As informações de contexto de cor serão usadas nas propriedades do bitmap, se especificadas.

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

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget