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ê deve criar a superfície usando o sinalizador D3D11_RESOURCE_MISC_GDI_COMPATIBLE para uma superfície ou usando o sinalizador DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE para cadeias de troca, caso contrário, esse método falhará.
• Você deve liberar o dispositivo e chamar o método IDXGISurface1::ReleaseDC antes de emitir novos comandos Direct3D.
• Esse método falhará se um DC pendente já tiver sido criado por esse método.
• O formato da superfície ou cadeia de troca deve ser DXGI_FORMAT_B8G8R8A8_UNORM_SRGB ou DXGI_FORMAT_B8G8R8A8_UNORM.
• No GetDC, o destino de renderização na fusão de saída do pipeline do Direct3D é desvinculado da superfície. Você deve chamar o método ID3D11DeviceContext::OMSetRenderTargets no dispositivo antes da renderização do Direct3D após a renderização de GDI.
• Antes de redimensionar buffers, você deve liberar todos os DCs pendentes.

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