Função ReleaseDC (winuser.h)

Artigo
03/13/2024

A função ReleaseDC libera um DC (contexto de dispositivo), liberando-o para uso por outros aplicativos. O efeito da função ReleaseDC depende do tipo de DC. Ele libera apenas DCs comuns e de janela. Ele não tem efeito em DCs privados ou de classe.

Sintaxe

int ReleaseDC(
  [in] HWND hWnd,
  [in] HDC  hDC
);

Parâmetros

[in] hWnd

Um identificador para a janela cujo DC deve ser liberado.

[in] hDC

Um identificador para o DC a ser liberado.

Retornar valor

O valor retornado indica se o DC foi liberado. Se o DC tiver sido liberado, o valor retornado será 1.

Se o DC não tiver sido liberado, o valor retornado será zero.

Comentários

O aplicativo deve chamar a função ReleaseDC para cada chamada para a função GetWindowDC e para cada chamada para a função GetDC que recupera um DC comum.

Um aplicativo não pode usar a função ReleaseDC para liberar um DC que foi criado chamando a função CreateDC ; em vez disso, ele deve usar a função DeleteDC . ReleaseDC deve ser chamado do mesmo thread chamado GetDC.

Exemplos

Para obter um exemplo, consulte Dimensionando uma imagem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll