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

  • Artigo

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

Sintaxe

HRESULT ReleaseDC(
  [in, optional] RECT *pDirtyRect
);

Parâmetros

[in, optional] pDirtyRect

Tipo: RECT*

Um ponteiro para uma estrutura RECT que identifica a sujo região da superfície.
Uma região sujo é qualquer parte da superfície que você usou para renderização GDI e que você deseja preservar. Essa área é usada como uma dica de desempenho para o subsistema gráfico em determinados cenários. Não use esse parâmetro para restringir a renderização para a região retangular especificada. Se você passar NULL, ReleaseDC considerará toda a superfície como sujo. Caso contrário, o ReleaseDC usa a área especificada pelo RECT como uma dica de desempenho para indicar quais áreas foram manipuladas pela renderização GDI.

Você pode passar um ponteiro para uma estrutura RECT vazia (um retângulo sem posição ou área) se não tiver alterado nenhum conteúdo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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

Use o método ReleaseDC para liberar o DC e indicar que o aplicativo terminou toda a renderização GDI para essa superfície.
Você deve chamar o método ReleaseDC antes de usar o Direct3D para executar renderização adicional.

Antes de redimensionar buffers, você deve liberar todos os DCs pendentes.

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