Структура DEVINFO (winddi.h)

Структура DEVINFO предоставляет сведения о драйвере и его частном PDEV графическому движку.

Синтаксис

typedef struct tagDEVINFO {
  FLONG    flGraphicsCaps;
  LOGFONTW lfDefaultFont;
  LOGFONTW lfAnsiVarFont;
  LOGFONTW lfAnsiFixFont;
  ULONG    cFonts;
  ULONG    iDitherFormat;
  USHORT   cxDither;
  USHORT   cyDither;
  HPALETTE hpalDefault;
  FLONG    flGraphicsCaps2;
} DEVINFO, *PDEVINFO;

Члены

flGraphicsCaps

Набор флагов, описывающих графические возможности графического драйвера и (или) его оборудования. Эти флаги определены в следующей таблице.

lfDefaultFont

Структура расширенного логического шрифта, указывающая шрифт по умолчанию для устройства. Дополнительные сведения об этой структуре см. в разделе EXTLOGFONT в документации по Microsoft Windows SDK.

lfAnsiVarFont

Структура расширенного логического шрифта, которая задает шрифт переменной тона по умолчанию для устройства. Дополнительные сведения об этой структуре см. в разделе EXTLOGFONT в документации по Windows SDK.

lfAnsiFixFont

Структура расширенного логического шрифта, которая задает шрифт фиксированного тона (монопространствен) по умолчанию для устройства. Дополнительные сведения об этой структуре см. в разделе EXTLOGFONT в документации по Windows SDK.

cFonts

Указывает количество шрифтов устройства. GDI предполагает, что устройство может рисовать текст с таким количеством шрифтов на собственных поверхностях, а драйвер может предоставлять сведения о метриках шрифтов. Если драйвер устанавливает для cFonts значение -1, GDI будет ожидать, пока не потребуются шрифты, чтобы запросить у драйвера фактическое количество поддерживаемых шрифтов в вызове DrvQueryFont.

iDitherFormat

Задает формат растрового изображения. Этот параметр указывает, сколько битов информации о цвете запрашивается на пиксель, и должен иметь одно из следующих значений:

cxDither

cyDither

Укажите размеры смеженой кисти. Если эти члены являются ненулевыми, устройство может создать кисть с мятой для заданного цвета RGB.

hpalDefault

Обработка палитры по умолчанию для устройства. Драйвер должен создать палитру, вызвав EngCreatePalette. Драйвер связывает палитру с устройством, возвращая этот дескриптор в GDI.

flGraphicsCaps2

Набор флагов, описывающих дополнительные графические возможности драйвера устройства. Эти флаги определены в следующей таблице.

Комментарии

Функция DrvEnablePDEV драйвера заполняет структуру DEVINFO; драйвер должен задавать только те члены, которые относятся к нему. Эта структура инициализируется GDI с нуля до вызова DrvEnablePDEV . Приложения не имеют прямого доступа к этой структуре.

Если драйвер задает GCAPS2_JPEGSRC или GCAPS2_PNGSRC в flGraphicsCaps2, применяются следующие правила:

• Драйвер должен предоставить функцию DrvQueryDeviceSupport .
• Каждая графическая функция DDI, определяемая драйвером, которая получает в качестве входных данных структуру SURFOBJ , должна поддерживать сжатый формат или возвращать код ошибки. В случае с драйверами принтеров для поддержки сжатого формата драйвер должен иметь возможность выполнять одну из следующих задач:
  • Если устройство печати может обработать сжатый формат JPEG/PNG, драйвер принтера должен передать сжатый формат в выходные данные языка описания страниц (PDL).
  • Если устройство печати не может обработать сжатый формат JPEG/PNG, драйвер принтера должен сначала преобразовать сжатый формат JPEG/PNG в другой формат изображения, который может обработать устройство печати. Затем драйвер принтера может сделать сведения об изображении доступными в выходных данных PDL драйвера.
    Примечание В случае преобразования формата JPEG/PNG в формат растрового изображения драйвер принтера не должен использовать функции GDI. Например, драйвер может использовать ВМЕСТО этого API компонента образов Windows (WIC) для выполнения преобразования.
     
• Драйвер должен иметь возможность обрабатывать сложные области клипа для изображений, использующих сжатый формат.
• Для определяемых драйвером графических функций DDI, получающих входной аргумент ROP4, используется только 0xCCCC с форматами JPEG и PNG.

Требования

См. также раздел

DrvEnablePDEV

DrvQueryFont

DrvRealizeBrush

DrvTextOut