Atributos somente no nível raiz
Importante
A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.
Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.
Atributos somente de nível raiz são atributos gerais que descrevem características específicas do driver, como nomes de arquivos de recursos, arquivos de ajuda ou arquivos GPD adicionais incluídos, juntamente com especificações para as unidades mestras do driver, o número da versão e a página de código de caracteres.
Atributos adicionais somente no nível raiz especificam características específicas do dispositivo, como o nome da impressora, o tipo, a capacidade máxima de cópia e o número de slots de cartucho de fonte.
Esses atributos são chamados de atributos somente no nível raiz porque sempre devem ser colocados em um arquivo GPD no nível raiz (ou seja, não dentro de chaves).
A tabela a seguir lista os atributos somente no nível raiz.
| Nome do atributo | AttributeParameter | Comentários |
|---|---|---|
| CodePage | Identificador de página de código do Windows com valor numérico. | Opcional. Se não for especificado, Unicode será usado. A página de código é aplicada a todas as cadeias de caracteres exibidas. |
| FontCartSlots | Valor numérico que representa o número de slots de cartucho de fonte fornecidos pela impressora. | Opcional. Se não for especificado, o valor padrão será zero. |
| GPDFileName | Cadeia de caracteres de texto entre aspas que representa o nome do arquivo GPD (sem caminho). | Opcional. |
| GPDFileVersion | Cadeia de caracteres de texto entre aspas que representa a versão atual do arquivo GPD. O formato recomendado é MajorVersion.MinorVersion, como "1.0". | Opcional. Se especificada, essa cadeia de caracteres é exibida na caixa de diálogo Sobre do Unidrv. |
| GPDSpecVersion | Cadeia de caracteres de texto entre aspas que representa a versão de especificação do GPD. O formato exigido é MajorVersion.MinorVersion, como "1.0". | Obrigatória. Deve ser a primeira entrada no arquivo GPD, antes de qualquer comentário. Esse valor deve ser "1.0" para Windows 2000. |
| HelpFile | Cadeia de caracteres entre aspas contendo o nome de um arquivo de ajuda personalizado, com uma extensão .hlp. | Opcional. Se incluído, ele pode adicionar tópicos ou substituir tópicos existentes no arquivo de ajuda do Unidrv. Os índices do arquivo de ajuda são especificados por atributos *HelpIndex para recursos e opções. |
| Incluir | Cadeia de caracteres entre aspas que contém o nome de um arquivo GPD adicional. | Obsoleto. Essa entrada foi redefinida como uma diretiva de pré-processador. |
| InstalledOptionName | Cadeia de caracteres entre aspas exibida para indicar que um recurso ou opção instalável está instalado. Normalmente, essa cadeia de caracteres é "Instalada", mas qualquer cadeia de caracteres apropriada pode ser especificada. | Obrigatório se *Instalável? é TRUE para quaisquer recursos ou opções (consulte Atributos de recurso) e se rcInstalledOptionNameID não for especificado. |
| MasterUnits | PAIR representando as unidades mestre da impressora. | Obrigatória. Para reduzir possíveis erros de arredondamento, use os mesmos valores para unidades de resolução nos dados de métricas de fonte especificados para MasterUnits. (Veja Unidrv Font Metrics em Gerenciamento de fontes personalizado.) |
| MaxCopies | Valor numérico que representa o número máximo de cópias que a impressora pode suportar. | Opcional. Se esse campo não for especificado, o valor padrão será 1. |
| ModelName | Cadeia de caracteres de texto entre aspas que representa o nome do modelo da impressora. | Necessário se rcModelNameID não for especificado. A cadeia de caracteres deve corresponder ao nome em setup.inf. |
| NotInstalledOptionName | Cadeia de caracteres entre aspas exibida para indicar que um recurso ou opção instalável não está instalado. Normalmente, essa cadeia de caracteres é "Not installed", mas qualquer cadeia de caracteres apropriada pode ser especificada. | Obrigatório se Installable? for TRUE para quaisquer recursos ou opções (consulte Atributos de recurso), e se rcNotInstalledOptionNameID não for especificado. |
| Personalidade | Cadeia de caracteres entre aspas que representa o idioma da impressora usado pela impressora. | Opcional. Se especificada, a cadeia de caracteres será exibida pelos Serviços de Diretório. Consulte também rcPersonalityID abaixo nessa tabela. |
| PrinterType | PAGE, SERIAL ou TTY | Obrigatório |
| PrintRate | Valor numérico que representa a taxa de impressão monocromática. As unidades são especificadas por PrintRateUnit. | Opcional. Se esse campo não for especificado, o valor padrão será 0. |
| PrintRatePPM | Valor numérico que representa a velocidade de impressão, em páginas por minuto. | Opcional. Se esse campo não for especificado, o valor padrão será 0. |
| PrintRateUnit | PPM - Páginas/min CPS - Caracteres/seg LPM - Linhas/min IPM - Polegadas/min. (IPM é para plotadoras) |
Obrigatório se PrintRate for especificado. A unidade especificada deve corresponder ao tipo de impressora. Por exemplo, o PPM deve ser especificado para impressoras de página. |
| rcInstalledOptionNameID | ID do recurso de um recurso de cadeia de caracteres que é exibido para indicar que um recurso ou opção instalável está instalado. Normalmente, essa cadeia de caracteres é "Instalada", mas qualquer cadeia de caracteres apropriada pode ser especificada. | Obrigatório se Installable? for TRUE para quaisquer recursos ou opções (consulte Atributos de recurso), e se InstalledOptionName não for especificado. |
| rcNotInstalledOptionNameID | ID do recurso de um recurso de cadeia de caracteres que é exibido para indicar que um recurso ou opção instalável não está instalado. Normalmente, essa cadeia de caracteres é "Not installed", mas qualquer cadeia de caracteres apropriada pode ser especificada. | Obrigatório se Installable? for TRUE para quaisquer recursos ou opções (consulte Atributos de recurso), e se NotInstalledOptionName não for especificado. |
| rcPersonalityID | ID de recurso de um recurso de cadeia de caracteres que representa o idioma da impressora usado pela impressora. | Opcional. Se especificada, a cadeia de caracteres será exibida pelos Serviços de Diretório. Veja também Personalidade. |
| rcPrinterIconID | ID de recurso de um recurso RC_ICON que representa um ícone associado à impressora. | Opcional. Se não for especificado, um ícone de impressora padrão será exibido. É recomendável que todas as RC_ICON IDs de recursos sejam numeradas de forma contígua, começando com 1. |
| ResourceDLL | Cadeia de caracteres entre aspas que contém o nome, sem informações de caminho, de uma DLL de recurso. | Opcional. Consulte Usando DLLs de recurso em um minidriver. |
Para obter informações sobre novos atributos somente de nível raiz para Windows Vista, consulte Novos atributos GPD somente de nível raiz para Windows Vista e Novos atributos PPD somente de nível raiz para Windows Vista.