Função CreateCompatibleDC (wingdi.h)

Artigo
03/09/2024

A função CreateCompatibleDC cria um DC (contexto de dispositivo de memória) compatível com o dispositivo especificado.

Sintaxe

HDC CreateCompatibleDC(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para um DC existente. Se esse identificador for NULL, a função criará um DC de memória compatível com a tela atual do aplicativo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o identificador para um DC de memória.

Se a função falhar, o valor retornado será NULL.

Comentários

Um DC de memória existe apenas na memória. Quando o DC de memória é criado, sua superfície de exibição tem exatamente um pixel monocromático de largura e um pixel monocromático de altura. Antes que um aplicativo possa usar um DC de memória para operações de desenho, ele deve selecionar um bitmap da largura e altura corretas no DC. Para selecionar um bitmap em um DC, use a função CreateCompatibleBitmap , especificando a altura, a largura e a organização de cores necessárias.

Quando um DC de memória é criado, todos os atributos são definidos como valores padrão normais. O DC de memória pode ser usado como um DC normal. Você pode definir os atributos; obter as configurações atuais de seus atributos; e selecione canetas, pincéis e regiões.

A função CreateCompatibleDC só pode ser usada com dispositivos que dão suporte a operações de raster. Um aplicativo pode determinar se um dispositivo dá suporte a essas operações chamando a função GetDeviceCaps .

Quando você não precisar mais do DC de memória, chame a função DeleteDC . Recomendamos que você chame DeleteDC para excluir o DC. No entanto, você também pode chamar DeleteObject com o HDC para excluir o DC.

Se hdc for NULL, o thread que chama CreateCompatibleDC será proprietário do HDC criado. Quando esse thread é destruído, o HDC não é mais válido. Portanto, se você criar o HDC e passá-lo para outro thread, saia do primeiro thread, o segundo thread não poderá usar o HDC.

ICM: Se o DC passado para essa função estiver habilitado para ICM (Gerenciamento de Cores de Imagem), o DC criado pela função será habilitado para ICM. Os espaços de cor de origem e de destino são especificados no DC.

Exemplos

Para obter um exemplo, consulte Capturando 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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll