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

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz