Método IDXGISurface1::GetDC (dxgi.h)

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.

Sintaxe

HRESULT GetDC(
        BOOL Discard,
  [out] HDC  *phdc
);

Parâmetros

Discard

Tipo: BOOL

Um valor booliano que especifica se o conteúdo do Direct3D deve ser preservado no DC GDI. TRUE direciona o runtime para não preservar o conteúdo do Direct3D no DC GDI; ou seja, o runtime descarta o conteúdo do Direct3D. FALSE garante que o conteúdo do Direct3D esteja disponível no DC GDI.

[out] phdc

Tipo: HDC*

Um ponteiro para um identificador HDC que representa o contexto atual do dispositivo para renderização de GDI.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um código de erro.

Comentários

Esse método 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).

Depois de usar o método GetDC para recuperar um DC, você pode renderizar para a superfície DXGI usando GDI.
O método GetDC lê a superfície para renderização de GDI e permite a interoperabilidade entre as tecnologias DXGI e GDI.

Tenha o seguinte em mente ao usar este método:

Você também pode chamar GetDC no buffer de fundo no índice 0 de uma cadeia de troca obtendo um IDXGISurface1 da cadeia de troca. O código a seguir ilustra o processo.

IDXGISwapChain* g_pSwapChain = NULL;
IDXGISurface1* g_pSurface1 = NULL;
...
//Setup the device and the swapchain
g_pSwapChain->GetBuffer(0, __uuidof(IDXGISurface1), (void**) &g_pSurface1);
g_pSurface1->GetDC( FALSE, &g_hDC );
...      
//Draw on the DC using GDI
...
//When finish drawing release the DC
g_pSurface1->ReleaseDC( NULL );
      

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
Biblioteca DXGI.lib

Confira também

DXGI Interfaces

IDXGISurface1