Partager via


Modules de configuration basés sur des fichiers GPD ou PPD

Important

La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.

Pour plus d’informations, veuillez consulter les articles Plateforme d’impression moderne et Guide de conception des applications de support d’impression.

Pour Windows Vista, les fichiers GPD et PPD contiennent le mappage de schéma d’impression et de nouvelles entrées spécifiques aux pilotes d’impression XPSDrv. Ces modifications s’appliquent aux fichiers GPD et PPD que vous pouvez utiliser pour créer des modules de configuration GPD uniquement ou PPD uniquement, et des modules de configuration pour les plug-ins de pilote d’impression Unidrv ou Pscript5.

Entrées GPD et PPD spécifiques à XPSDrv

Pour créer un module de configuration de pilote d’impression version 3 pour un pilote d’impression XPSDrv à l’aide d’un fichier GPD ou PPD, vous devez effectuer l’une des opérations suivantes :

  • Créez ou modifiez le fichier GPD ou PPD. Le fichier doit inclure les mots clés de configuration qui décrivent les fonctionnalités prises en charge par l’imprimante. Les mots clés GPD ou PPD standard sont automatiquement mappés aux mots clés de schéma d’impression public, mais les mots clés non standard sont mappés à un espace de noms privé, par défaut.

  • Incluez le fichier Msxpsinc.gpd si vous créez un fichier GPD, ou le fichier Msxpsinc.ppd si vous créez un fichier PPD. Ces fichiers incluent les mots clés suivants, qui indiquent que le fichier de configuration résultant fait partie d’un pilote d’impression XPSDrv.

    Pour Msxpsinc.gpd, il contient :

    IsXPSDriver?: TRUE
    

    Pour Msxpsinc.ppd, il contient :

    *MSIsXPSDriver: True
    

L’inclusion du fichier Msxpsinc.gpd ou Msxpsinc.ppd est l’approche recommandée plutôt que d’ajouter ces attributs au fichier GPD ou PPD. Microsoft pourrait ajouter des attributs futurs pour les pilotes XPSDrv au fichier d'inclusion approprié. Si Microsoft ajoute les nouveaux attributs au fichier d'inclusion et que vous utilisez le fichier d'inclusion dans votre fichier GPD ou PPD, vous n’aurez pas besoin de modifier le fichier GPD ou PPD du pilote d’impression.

Les fichiers GPD ou PPD racines (qui sont spécifiés dans le fichier INF en tant que DataFile du pilote) pour tous les pilotes XPSDrv basés sur le pilote Microsoft Unidrv ou PScript5 doivent inclure le fichier Msxpsinc.gpd ou Msxpsinc.ppd correspondant.

Par exemple, pour Model-foo.gpd, incluez :

*Include: "msxpsinc.gpd"

Pour Model-foo.ppd, incluez :

*Include: "msxpinc.ppd"

Le mappage de schéma d’impression est une fonctionnalité des modules de configuration Unidrv et PScript5 qui traduit les mots clés GPD et PPD en mots clés de schéma d’impression public équivalents. Par défaut, tous les mots clés GPD et PPD standard sont mappés à leurs mots clés équivalents du schéma d’impression public. Les mots clés non standard d’un fichier GPD ou PPD sont, quant à eux, mappés à un espace de noms privé et spécifique à l’appareil par défaut. Vous pouvez améliorer ce mappage en effectuant une ou les deux opérations suivantes :

  • Spécifier l’espace de noms privé pour les mots clés non standard.

  • Associer des mots clés de fonctionnalité et d’option non standard dans le fichier GPD ou PPD avec leurs mots clés équivalents à partir du schéma d’impression public dans le fichier GPD ou PPD. Cette association permet au module de configuration de générer les données PrintTicket et PrintCapabilities en tant que fonctionnalités de schéma d’impression public.

Exemple de fichier GPD

L’exemple de code suivant montre un fichier GPD qui illustre les entrées et les mots clés pour créer un module de configuration version 3 pour un pilote d’impression 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"  }
}