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

Статья
11/20/2024

Функция createIC создает контекст сведений для указанного устройства. Контекст сведений обеспечивает быстрый способ получения сведений об устройстве без создания контекста устройства (DC). Однако функции рисования GDI не могут принимать дескриптор в контекст информации.

Синтаксис

HDC CreateICA(
  [in] LPCSTR         pszDriver,
  [in] LPCSTR         pszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

Параметры

[in] pszDriver

Указатель на строку символов, завершающую значение NULL, которая указывает имя драйвера устройства (например, Epson).

[in] pszDevice

Указатель на строку символов, завершающую значение NULL, которая указывает имя используемого устройства вывода, как показано в диспетчере печати (например, Epson FX-80). Это не имя модели принтера. Необходимо использовать параметр lpszDevice.

pszPort

Этот параметр игнорируется и должен иметь значение NULL. Он предоставляется только для совместимости с 16-разрядной версией Windows.

[in] pdm

Указатель на структуру DEVMODE, содержащую данные инициализации для драйвера устройства. Функция DocumentProperties извлекает эту структуру, заполненную для указанного устройства. Параметр lpdvmInit должен быть null, если драйвер устройства должен использовать инициализацию по умолчанию (если таковой есть), указанной пользователем.

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

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

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

Замечания

Если вам больше не нужна информация, вызовите функцию DeleteDC.

Заметка

Заголовок wingdi.h определяет CreateIC как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll