Compartilhar via


Interface IDXGISurface1 (dxgi.h)

A interface IDXGISurface1 estende o IDXGISurface adicionando suporte ao uso da GDI (Interface de Dispositivo de Gráficos do Windows) para renderizar em uma superfície DXGI (Infraestrutura Gráfica) do Microsoft DirectX.

Herança

A interface IDXGISurface1 herda de IDXGISurface. IDXGISurface1 também tem estes tipos de membros:

Métodos

A interface IDXGISurface1 tem esses métodos.

 
IDXGISurface1::GetDC

Retorna um DC (contexto de dispositivo) que permite renderizar para uma superfície DXGI (Infraestrutura Gráfica) do Microsoft DirectX usando a GDI (Interface de Dispositivo gráfico) do Windows.
IDXGISurface1::ReleaseDC

Libera o DC (contexto do dispositivo GDI) associado à superfície atual e permite que você use o Direct3D para renderizar.

Comentários

Essa interface não tem suporte do DXGI 1.0, que foi enviado no Windows Vista e no Windows Server 2008. O suporte ao DXGI 1.1 é necessário, que está disponível no Windows 7, windows server 2008 R2 e como uma atualização para o Windows Vista com Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).

Um objeto image-data é uma seção 2D de memória, normalmente chamada de superfície. Para obter a superfície de uma saída, chame IDXGIOutput::GetDisplaySurfaceData. Em seguida, chame QueryInterface no objeto IDXGISurface que IDXGIOutput::GetDisplaySurfaceData retorna para recuperar a interface IDXGISurface1 .

Qualquer objeto que dê suporte a IDXGISurface também dá suporte a IDXGISurface1.

O runtime cria automaticamente uma interface IDXGISurface1 quando cria um objeto de recurso Direct3D que representa uma superfície. Por exemplo, o runtime cria uma interface IDXGISurface1 quando você chama ID3D11Device::CreateTexture2D ou ID3D10Device::CreateTexture2D para criar uma textura 2D. Para recuperar a interface IDXGISurface1 que representa a superfície de textura 2D, chame ID3D11Texture2D::QueryInterface ou ID3D10Texture2D::QueryInterface. Nesta chamada, você deve passar o identificador de IDXGISurface1. Se a textura 2D tiver apenas um único nível de mapa MIP e não consistir em uma matriz de texturas, QueryInterface terá êxito e retornará um ponteiro para o ponteiro da interface IDXGISurface1 . Caso contrário, QueryInterface falhará e não retornará o ponteiro para IDXGISurface1.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dxgi.h

Confira também

DXGI Interfaces

IDXGISurface