Атрибуты только для корневого уровня

Внимание

Современная платформа печати — это предпочтительный способ взаимодействия с принтерами Windows. Рекомендуется использовать драйвер класса "Входящие" Microsoft IPP вместе с приложениями поддержки печати (PSA), чтобы настроить возможности печати в Windows 10 и 11 для разработки устройств принтера.

Дополнительные сведения см. в руководстве по проектированию приложений поддержки печати версии 1 и версии 2.

Атрибуты только для корневого уровня — это общие атрибуты , описывающие такие характеристики драйвера, как имена файлов ресурсов, файлов справки или дополнительных включенных файлов GPD, а также спецификации основных единиц драйвера, номера версии и кодовой страницы символов.

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

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

В следующей таблице перечислены атрибуты только для корневого уровня.

Имя атрибута	AttributeParameter	Комментарии
CodePage	Идентификатор кодовой страницы Windows с числовым значением.	Необязательно. Если это не указано, используется Юникод. Кодовая страница применяется ко всем отображаемым строкам.
FontCartSlots	Числовое значение, представляющее количество слотов патронов шрифта, предоставляемых принтером.	Необязательно. Если значение не указано, значение по умолчанию равно нулю.
GPDFileName	В кавычках текстовая строка, представляющая имя файла GPD (без пути).	Необязательно.
GPDFileVersion	В кавычках текстовая строка, представляющая текущую версию файла GPD. Рекомендуемый формат — MajorVersion.MinorVersion, например "1.0".	Необязательно. Если задано, эта строка отображается в диалоговом окне "Сведения о юнирве".
GPDSpecVersion	Текстовая строка с кавычками, представляющая текущую версию спецификации GPD. Обязательный формат — MajorVersion.MinorVersion, например "1.0".	Обязательный. Прежде чем примечания, необходимо сначала вступить в файл GPD. Это значение должно быть "1.0" для Windows 2000.
HelpFile	В кавычках строка, содержащая имя настраиваемого файла справки с расширением HLP.	Необязательно. Если он включен, он может добавлять разделы или перезаписывать существующие разделы в файле справки Unidrv. Индексы файлов справки задаются атрибутами *HelpIndex для функций и параметров.
Включить	В кавычках строка, содержащая имя дополнительного файла GPD.	Является устаревшей. Эта запись была переопределена как директива препроцессора.
InstalledOptionName	Строка с кавычками, отображаемая для указания установленной функции или параметра. Как правило, эта строка имеет значение "Установлено", но можно указать любую соответствующую строку.	Требуется, если *Установить? значение TRUE для любых функций или параметров (см . атрибуты компонента), а если rcInstalledOptionNameID не указан.
MasterUnits	ПАРА, представляющая главные единицы принтера.	Обязательный. Чтобы уменьшить потенциальные ошибки округления, используйте те же значения для единиц разрешения в данных метрик шрифта, которые указываются для MasterUnits. (См. метрики шрифта Unidrv в Настраиваемое управление шрифтами.)
MaxCopies	Числовое значение, представляющее максимальное количество копий принтера, может поддерживаться.	Необязательно. Если значение по умолчанию не указано, значение по умолчанию равно 1.
ModelName	Строка в кавычках, представляющая имя модели принтера.	Требуется, если rcModelNameID не указан. Строка должна соответствовать имени в setup.inf.
NotInstalledOptionName	В кавычках отображается строка, указывающая, что устанавливаемая функция или параметр не установлена. Как правило, эта строка не установлена, но можно указать любую соответствующую строку.	Требуется, если можно установить? Имеет значение TRUE для каких-либо компонентов или параметров (см . атрибуты компонента), и если rcNotInstalledOptionNameID не указан.
Персонализация	В кавычках строка, представляющая язык принтера, используемый принтером.	Необязательно. Если задано, строка отображается службами каталогов. Также см . код rcPersonalityID ниже в этой таблице.
PrinterType	PAGE, SERIAL или TTY	Обязательное поле
PrintRate	Числовое значение, представляющее частоту монохромной печати. Единицы указываются в PrintRateUnit.	Необязательно. Если значение не указано, значение по умолчанию равно 0.
PrintRatePPM	Числовое значение, представляющее скорость печати на страницах в минуту.	Необязательно. Если значение не указано, значение по умолчанию равно 0.
PrintRateUnit	PPM - Страниц/мин CPS — символы/с LPM — линии/мин IPM — дюймы/мин. (IPM предназначен для графиков)	Требуется, если указана функция PrintRate . Указанная единица должна соответствовать типу принтера. Например, PPM следует указать для принтеров страниц.
rcInstalledOptionNameID	Идентификатор ресурса строки, отображаемого для указания устанавливаемой функции или параметра. Как правило, эта строка имеет значение "Установлено", но можно указать любую соответствующую строку.	Требуется, если можно установить? Имеет значение TRUE для каких-либо компонентов или параметров (см . атрибуты компонентов), и если InstallOptionName не указан.
rcNotInstalledOptionNameID	Идентификатор ресурса строки, отображаемого для указания возможности установки или параметра, не установлен. Как правило, эта строка не установлена, но можно указать любую соответствующую строку.	Требуется, если можно установить? Имеет значение TRUE для каких-либо компонентов или параметров (см . атрибуты компонентов), а если NotInstalledOptionName не указан.
rcPersonalityID	Идентификатор ресурса строки, представляющего язык принтера, используемый принтером.	Необязательно. Если задано, строка отображается службами каталогов. Также см . личность.
rcPrinterIconID	Идентификатор ресурса RC_ICON ресурса, представляющего значок, связанный с принтером.	Необязательно. Если не указано, отображается значок принтера по умолчанию. Рекомендуется, чтобы все идентификаторы ресурсов RC_ICON были нумерованы последовательно, начиная с 1.
ResourceDLL	В кавычках строка, содержащая имя без сведений о пути, библиотеки DLL ресурсов.	Необязательно. См. сведения об использовании библиотек DLL ресурсов в мини-driver.

Дополнительные сведения о новых атрибутах только для корневого уровня для Windows Vista см. в статье "Новые атрибуты GPD только для корневого уровня" для Windows Vista и новые атрибуты PPD только для корневого уровня для Windows Vista.