Función CreateCompatibleDC (wingdi.h)

Artículo
03/13/2024

La función CreateCompatibleDC crea un contexto de dispositivo de memoria (DC) compatible con el dispositivo especificado.

Sintaxis

HDC CreateCompatibleDC(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador de un controlador de dominio existente. Si este identificador es NULL, la función crea un controlador de dominio de memoria compatible con la pantalla actual de la aplicación.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el identificador de un controlador de dominio de memoria.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Un controlador de dominio de memoria solo existe en memoria. Cuando se crea el CONTROLADOR de dominio de memoria, su superficie de presentación es exactamente un píxel monocromo ancho y un píxel monocromo alto. Para que una aplicación pueda usar un controlador de dominio de memoria para las operaciones de dibujo, debe seleccionar un mapa de bits del ancho y alto correctos en el controlador de dominio. Para seleccionar un mapa de bits en un controlador de dominio, use la función CreateCompatibleBitmap , especificando la organización de alto, ancho y color necesaria.

Cuando se crea un controlador de dominio de memoria, todos los atributos se establecen en valores predeterminados normales. El controlador de dominio de memoria se puede usar como un controlador de dominio normal. Puede establecer los atributos; obtener la configuración actual de sus atributos; y seleccione lápices, pinceles y regiones.

La función CreateCompatibleDC solo se puede usar con dispositivos que admiten operaciones de trama. Una aplicación puede determinar si un dispositivo admite estas operaciones mediante una llamada a la función GetDeviceCaps .

Cuando ya no necesite el controlador de dominio de memoria, llame a la función DeleteDC . Se recomienda llamar a DeleteDC para eliminar el controlador de dominio. Sin embargo, también puede llamar a DeleteObject con hdC para eliminar el controlador de dominio.

Si hdc es NULL, el subproceso que llama a CreateCompatibleDC posee el HDC que se crea. Cuando se destruye este subproceso, la HDC ya no es válida. Por lo tanto, si crea la HDC y la pasa a otro subproceso, salga del primer subproceso, el segundo subproceso no podrá usar la HDC.

ICM: Si el controlador de dominio que se pasa a esta función está habilitado para Image Color Management (ICM), el controlador de dominio creado por la función está habilitado para ICM. Los espacios de color de origen y destino se especifican en el controlador de dominio.

Ejemplos

Para obtener un ejemplo, consulte Captura de una imagen.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll