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.
[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).
- 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 |