Partilhar via

Módulos de configuração baseados em arquivos GPD ou PPD

  • Artigo

Importante

A plataforma de impressão moderna é o meio preferido 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.

Para Windows Vista, os arquivos GPD e PPD contêm mapeamento de esquema de impressão e novas entradas específicas para drivers de impressão XPSDrv. Essas mudanças se aplicam aos arquivos GPD e PPD que podem ser usados para criar módulos de configuração somente GPD ou somente PPD e módulos de configuração para plug-ins de driver de impressão Unidrv ou Pscript5.

Entradas GPD e PPD específicas do XPSDrv

Para criar um módulo de configuração de driver de impressão Versão 3 para um driver de impressão XPSDrv usando um arquivo GPD ou PPD, você deve executar um dos seguintes procedimentos:

  • Crie ou edite o arquivo GPD ou PPD. O arquivo deve incluir as palavras-chave de configuração que descrevem os recursos compatíveis com a impressora. As palavras-chave GPD ou PPD padrão são mapeadas automaticamente para palavras-chave públicas do Esquema de Impressão, mas as palavras-chave não padrão são mapeadas para um namespace privado, por padrão.

  • Inclua o arquivo Msxpsinc.gpd, se você estiver criando um arquivo GPD, ou o arquivo Msxpsinc.ppd, se estiver criando um arquivo PPD. Esses arquivos incluem as seguintes palavras-chave, que indicam que o arquivo de configuração resultante fará parte de um driver de impressão XPSDrv.

    Para Msxpsinc.gpd, ele contém:

    IsXPSDriver?: TRUE

    Para Msxpsinc.ppd, ele contém:

    *MSIsXPSDriver: True

Incluir o arquivo Msxpsinc.gpd ou Msxpsinc.ppd é a abordagem preferencial, em vez de adicionar esses atributos ao arquivo GPD ou PPD. A Microsoft pode adicionar atributos futuros para drivers XPSDrv ao arquivo de inclusão apropriado. Se a Microsoft adicionar os novos atributos ao arquivo de inclusão e você usar o arquivo de inclusão em seu arquivo GPD ou PPD, não será necessário editar o arquivo GPD ou PPD do driver de impressão.

Os arquivos GPD ou PPD raiz (que são especificados no arquivo INF como o DataFile do driver) para todos os drivers XPSDrv baseados em driver Microsoft Unidrv ou PScript5 devem incluir o arquivo Msxpsinc.gpd ou Msxpsinc.ppd correspondente.

Por exemplo, para Model-foo.gpd, inclua:

*Include: "msxpsinc.gpd"

Para Model-foo.ppd, inclua:

*Include: "msxpinc.ppd"

O mapeamento do Esquema de Impressão é um recurso dos módulos de configuração Unidrv e PScript5 que converte as palavras-chave GPD e PPD em suas palavras-chave públicas equivalentes do Esquema de Impressão. Por padrão, todas as palavras-chave GPD e PPD padrão são mapeadas para suas palavras-chave de esquema de impressão públicas equivalentes. Palavras-chave não padrão em um arquivo GPD ou PPD, no entanto, são mapeadas para um namespace privado específico do dispositivo por padrão. Você pode melhorar esse mapeamento executando um ou ambos os procedimentos a seguir:

  • Especificando o namespace privado para palavras-chave não padrão.

  • Associar palavras-chave de recurso e opção não padrão no arquivo GPD ou PPD com suas palavras-chave equivalentes do esquema de impressão público no arquivo GPD ou PPD. Essa associação permite que o módulo de configuração gere os dados PrintTicket e PrintCapabilities como recursos públicos do Esquema de Impressão.

Exemplo de arquivo GPD

O exemplo de código a seguir mostra um arquivo GPD que ilustra as entradas e palavras-chave para criar um módulo de configuração Versão 3 para um driver de impressão XPSDrv.

*%
*% Copyright (c) 2004 - 2006 Microsoft Corporation
*% All Rights Reserved.
*%
*GPDFileVersion: "1.0"
*GPDSpecVersion: "1.0"
*GPDFileName:    "plugfest.gpd"
*Include:        "StdNames.gpd"
*%
*% Include XPSDrv include file
*%
*Include:        "MSXpsInc.gpd"
*ModelName:      "Microsoft XPS Passthrough Driver Sample"
*MasterUnits:    PAIR(1200, 1200)
*ResourceDLL:    "unires.dll"
*PrinterType:    PAGE
*MaxCopies:      1

*%
*% IHV Private Namespace
*%
*PrintSchemaPrivateNamespaceURI:"https://www.ihv.com/schema/2006"
*%
*% IHV Private Feature
*%
*Feature: IHVStapling { 
*PrintSchemaKeywordMap: "JobStapleAllDocuments"
*Option: Enabled {
  *PrintSchemaKeywordMap: "StapleTopLeft" }
*Option: Disabled {
  *PrintSchemaKeywordMap: "None"  }
}