Функция 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. |
Замечания по платформе |
Не имеется |