Compartilhar via


Atributos somente de nível raiz

Importante

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 o Guia de design do aplicativo de suporte à impressão.

Atributos somente de nível raiz são atributos gerais que descrevem características específicas do driver, como os nomes de arquivos de recursos, arquivos de ajuda ou arquivos GPD adicionais incluídos, juntamente com especificações para as unidades mestras, número de versão e página de código de caractere do driver.

Atributos adicionais somente de nível raiz especificam características específicas do dispositivo, como o nome, o tipo, a capacidade máxima de cópia e o número de slots de cartucho de fonte da impressora.

Esses atributos são chamados de atributos somente de 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 de 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, o 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 texto entre aspas que representa o nome do arquivo GPD (sem caminho). Opcional.
GPDFileVersion Cadeia de texto entre aspas que representa a versão atual do arquivo GPD. O formato recomendado é MajorVersion.MinorVersion, como "1.0". Opcional. Se especificado, essa cadeia de caracteres será exibida na caixa de diálogo Sobre do Unidrv.
GPDSpecVersion Cadeia de texto entre aspas que representa a versão atual da especificação GPD. O formato necessário é 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 o Windows 2000.
Arquivo de Ajuda Cadeia de caracteres entre aspas que contém 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 pelos 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 que é 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.
Unidades Mestras PAIR que representa as unidades mestras da impressora. Obrigatória. Para reduzir possíveis erros de arredondamento, use os mesmos valores para unidades de resolução em dados de métricas de fonte especificados para MasterUnits. (Veja Métricas de fonte Unidrv em Gerenciamento de fontes personalizado.)
MaxCópias Valor numérico que representa o número máximo de cópias que a impressora pode suportar. Opcional. Se não for especificado, o valor padrão será 1.
ModelName Cadeia 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 que é exibida para indicar que um recurso ou opção instalável não está instalado. Normalmente, essa cadeia de caracteres é "Não instalada", mas qualquer cadeia de caracteres apropriada pode ser especificada. Obrigatório se instalável? 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 especificado, a cadeia de caracteres será exibida pelos Serviços de Diretório. Veja também rcPersonalityID abaixo nesta tabela.
Tipo de impressora PÁGINA, SÉRIE ou TTY Obrigatório
Taxa de impressão 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 plotters)
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 de 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 de 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 é "Não 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 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 especificado, a cadeia de caracteres será exibida pelos Serviços de Diretório. Veja também Personalidade.
rcPrinterIconID ID do 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 IDs de recursos RC_ICON 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 o 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.