Compartilhar via


Método ID2D1Bitmap1::GetSurface (d2d1_1.h)

Obtém a superfície especificada quando o bitmap foi criado ou a superfície padrão criada quando o bitmap foi criado.

Sintaxe

HRESULT GetSurface(
  [out, optional] IDXGISurface **dxgiSurface
);

Parâmetros

[out, optional] dxgiSurface

Tipo: IDXGISurface**

A superfície DXGI subjacente para o 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.
D2DERR_BITMAP_BOUND_AS_TARGET Não é possível desenhar com um bitmap que está associado atualmente como o bitmap de destino.

Comentários

O bitmap usado deve ter sido criado a partir de um destino de renderização de superfície DXGI, um destino de renderização derivada ou um contexto de dispositivo criado a partir de um ID2D1Device.

A superfície retornada pode ser usada com o Microsoft Direct3D ou qualquer outra API que interopere com superfícies compartilhadas. O aplicativo deve garantir transitivamente que a superfície seja utilizável no dispositivo Direct3D usado neste contexto. Por exemplo, se estiver usando a superfície com Direct2D o destino de renderização Direct2D deverá ter sido criado por meio de ID2D1Factory::CreateDxgiSurfaceRenderTarget ou em um contexto de dispositivo criado no mesmo dispositivo.

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

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap