Função CreateCompatibleDC (wingdi.h)

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

Confira também

Createcompatiblebitmap

Deletedc

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

Getdevicecaps