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

Статья
08/27/2023

Функция 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.

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

Требования

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