Condividi tramite


Moduli di configurazione basati su file GPD o PPD

Importante

La piattaforma di stampa moderna è il mezzo preferito di Windows per comunicare con le stampanti. Ti consigliamo di usare il driver di classe IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi per stampanti.

Per altre informazioni, vedere Piattaforma di stampa moderna e guida alla progettazione dell'app di supporto per la stampa.

Per Windows Vista, i file GPD e PPD contengono il mapping dello schema di stampa e le nuove voci specifiche dei driver di stampa XPSDrv. Queste modifiche si applicano ai file GPD e PPD che è possibile usare per creare moduli di configurazione e moduli di configurazione solo PPD o GPD per plug-in di driver di stampa Unidrv o Pscript5.

Voci GPD e PPD specifiche di XPSDrv

Per creare un modulo di configurazione del driver di stampa versione 3 per un driver di stampa XPSDrv usando un GPD o un file PPD, è necessario eseguire una delle operazioni seguenti:

  • Creare o modificare il file GPD o PPD. Il file deve includere le parole chiave di configurazione che descrivono le funzionalità supportate dalla stampante. Le parole chiave STANDARD GPD o PPD vengono mappate automaticamente alle parole chiave dello schema di stampa pubblico, ma per impostazione predefinita le parole chiave non standard vengono mappate a uno spazio dei nomi privato.

  • Includere il file Msxpsinc.gpd, se si sta creando un file GPD o il file Msxpsinc.ppd, se si sta creando un file PPD. Questi file includono le parole chiave seguenti, che indicano che il file di configurazione risultante farà parte di un driver di stampa XPSDrv.

    Per Msxpsinc.gpd, contiene:

    IsXPSDriver?: TRUE
    

    Per Msxpsinc.ppd, contiene:

    *MSIsXPSDriver: True
    

L'inclusione del file Msxpsinc.gpd o Msxpsinc.ppd è l'approccio preferito anziché aggiungere questi attributi al file GPD o PPD. Microsoft potrebbe aggiungere attributi futuri per i driver XPSDrv al file di inclusione appropriato. Se Microsoft aggiunge i nuovi attributi al file di inclusione e si usa il file di inclusione nel file GPD o PPD, non sarà necessario modificare il file GPD o PPD del driver di stampa.

I file GPD radice o PPD (specificati nel file INF come driver DataFile) per tutti i driver XPSDrv o PScript5 basati su driver Microsoft devono includere il file Msxpsinc.gpd o Msxpsinc.ppd corrispondente.

Ad esempio, per Model-foo.gpd, includere:

*Include: "msxpsinc.gpd"

Per Model-foo.ppd, includere:

*Include: "msxpinc.ppd"

Il mapping dello schema di stampa è una funzionalità dei moduli di configurazione Unidrv e PScript5 che converte le parole chiave GPD e PPD nelle parole chiave dello schema di stampa pubblico equivalenti. Per impostazione predefinita, tutte le parole chiave GPD e PPD standard vengono mappate alle parole chiave dello schema di stampa pubblico equivalenti. Le parole chiave non standard in un file GPD o PPD, tuttavia, vengono mappate a uno spazio dei nomi privato specifico del dispositivo per impostazione predefinita. È possibile migliorare questo mapping eseguendo una o entrambe le operazioni seguenti:

  • Specifica dello spazio dei nomi privato per le parole chiave non standard.

  • Associazione di parole chiave Feature e Option non standard nel file GPD o PPD con le parole chiave equivalenti dello schema di stampa pubblico nel file GPD o PPD. Questa associazione consente al modulo di configurazione di generare i dati PrintTicket e PrintCapabilities come funzionalità dello schema di stampa pubblico.

Esempio di file GPD

L'esempio di codice seguente mostra un file GPD che illustra le voci e le parole chiave per creare un modulo di configurazione versione 3 per un driver di stampa 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"  }
}