Функция CreateICA (wingdi.h)
Функция 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | wingdi.h (включая Windows.h) |
Библиотека | Gdi32.lib |
DLL | Gdi32.dll |