Функция CreateCompatibleDC (wingdi.h)

Статья
08/27/2023

Функция CreateCompatibleDC создает контекст устройства памяти (DC), совместимый с указанным устройством.

Синтаксис

HDC CreateCompatibleDC(
  [in] HDC hdc
);

Параметры

[in] hdc

Дескриптор существующего контроллера домена. Если этот дескриптор имеет значение NULL, функция создает контроллер памяти, совместимый с текущим экраном приложения.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для контроллера домена памяти.

Если функция завершается сбоем, возвращается значение NULL.

Контроллер домена памяти существует только в памяти. При создании контроллера памяти область отображения составляет ровно один монохромный пиксель в ширину и один монохромный пиксель в высоту. Прежде чем приложение сможет использовать контроллер памяти для операций рисования, оно должно выбрать растровое изображение правильной ширины и высоты в контроллере домена. Чтобы выбрать растровое изображение в контроллере домена, используйте функцию CreateCompatibleBitmap , указав необходимую высоту, ширину и цвет.

При создании контроллера домена памяти всем атрибутам присваиваются обычные значения по умолчанию. Контроллер памяти может использоваться в качестве обычного контроллера домена. Можно задать атрибуты; получение текущих параметров его атрибутов; и выберите ручки, кисти и области.

Функцию CreateCompatibleDC можно использовать только с устройствами, поддерживающими растровые операции. Приложение может определить, поддерживает ли устройство эти операции, вызвав функцию GetDeviceCaps .

Если контроллер домена памяти больше не нужен, вызовите функцию DeleteDC . Мы рекомендуем вызвать DeleteDC , чтобы удалить контроллер домена. Однако вы также можете вызвать DeleteObject с HDC, чтобы удалить контроллер домена.

Если hdc имеет значение NULL, поток, вызывающий CreateCompatibleDC , владеет созданным HDC. При уничтожении этого потока HDC становится недействительным. Таким образом, если создать HDC и передать его в другой поток, а затем выйти из первого потока, второй поток не сможет использовать HDC.

ICM: Если контроллер домена, передаваемый в эту функцию, включен для управления цветом изображений (ICM), контроллер домена, созданный функцией, будет включен с поддержкой ICM. Исходные и целевые цветовые пространства указываются в контроллере домена.

Примеры

Пример см. в разделе Запись изображения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll