Функция CreateIC

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

Синтаксис

HDC CreateIC(
  LPCTSTR lpszDriver,       // имя драйвера
  LPCTSTR lpszDevice,       // название устройства
  LPCTSTR lpszOutput,       // порт или имя файла
  CONST DEVMODE *lpdvmInit  // необязательные данные инициализации
);

Параметры

lpszDriver

[in] Указатель на строку символов с нулем в конце, которая определяет имя драйвера устройства (например, Epson).

lpszDevice

[in] Указатель на строку символов с нулем в конце, которая определяет название используемого устройства вывода, как показано в окне диалога Диспетчер печати (Print Manager) (например, Epson FX-80). Это - не имя модели принтера. Параметр lpszDevice должен быть использован.

lpszOutput

Этот параметр игнорируется и должен устанавливаться в ПУСТО (NULL). Он предусматривается только для совместимости с 16-битовым Windows.

lpdvmInit

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

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

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

Если функция завершается с ошибкой, возвращаемое значение - ПУСТО (NULL).

Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Когда вам больше не требуется информационный DC, вызовите функцию DeleteDC.

Windows 95/98/Me: CreateICW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор Контексты устройства, Функции, используемые контекстами устройства, DeleteDC, DocumentProperties, DEVMODE, GetDeviceCaps

Размещение и совместимость CreateIC
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и старше
Windows Me	Нет
Windows 98	Нет
Windows 95	Нет
Используемая библиотека	Gdi32.lib
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Реализуется как версии Unicode и ANSI для Windows 2000/XP. А также поддерживается программой Microsoft Layer for Unicode.
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки