Bagikan melalui

Modul Konfigurasi Berdasarkan File GPD atau PPD

Penting

Platform cetak modern adalah sarana komunikasi pilihan Windows dengan printer. Kami menyarankan agar Anda menggunakan driver kelas kotak masuk IPP Microsoft, bersama dengan Print Support Apps (PSA), untuk menyesuaikan pengalaman cetak di Windows 10 dan 11 untuk pengembangan perangkat printer.

Untuk informasi selengkapnya, lihat panduan desain aplikasi dukungan Print.

Untuk file Windows Vista, GPD dan PPD berisi pemetaan Skema Cetak dan entri baru yang khusus untuk driver cetak XPSDrv. Perubahan ini berlaku untuk file GPD dan PPD yang dapat Anda gunakan untuk membuat modul konfigurasi khusus GPD atau PPD dan modul konfigurasi untuk plug-in driver cetak Unidrv atau Pscript5.

Entri GPD dan PPD Khusus XPSDrv

Untuk membuat modul konfigurasi driver cetak Versi 3 untuk driver cetak XPSDrv dengan menggunakan GPD atau file PPD, Anda harus melakukan salah satu hal berikut:

  • Buat atau edit file GPD atau PPD. File harus menyertakan kata kunci konfigurasi yang menjelaskan fitur yang didukung printer. Kata kunci GPD atau PPD standar secara otomatis dipetakan ke kata kunci Skema Cetak publik, tetapi kata kunci nonstandar dipetakan ke namespace privat, secara default.

  • Sertakan file Msxpsinc.gpd, jika Anda membuat file GPD, atau file Msxpsinc.ppd, jika Anda membuat file PPD. File-file ini mencakup kata kunci berikut, yang menunjukkan bahwa file konfigurasi yang dihasilkan akan menjadi bagian dari driver cetak XPSDrv.

    Untuk Msxpsinc.gpd, berisi:

    IsXPSDriver?: TRUE

    Untuk Msxpsinc.ppd, berisi:

    *MSIsXPSDriver: True

Termasuk Msxpsinc.gpd atau file Msxpsinc.ppd adalah pendekatan yang lebih disukai daripada menambahkan atribut ini ke GPD atau file PPD. Microsoft dapat menambahkan atribut di masa mendatang untuk driver XPSDrv ke file sertakan yang sesuai. Jika Microsoft menambahkan atribut baru ke file sertakan dan Anda menggunakan file sertakan dalam file GPD atau PPD, Anda tidak perlu mengedit file GPD atau PPD driver cetak.

File GPD akar atau PPD (yang ditentukan dalam file INF sebagai driver DataFile) untuk semua driver XPSDrv berbasis driver Microsoft Unidrv atau PScript5 harus menyertakan file Msxpsinc.gpd atau Msxpsinc.ppd yang sesuai.

Misalnya, untuk Model-foo.gpd, meliputi:

*Include: "msxpsinc.gpd"

Untuk Model-foo.ppd, meliputi:

*Include: "msxpinc.ppd"

Pemetaan Skema Cetak adalah fitur modul konfigurasi Unidrv dan PScript5 yang menerjemahkan kata kunci GPD dan PPD ke kata kunci Skema Cetak publik yang setara. Secara default, semua kata kunci GPD dan PPD standar dipetakan ke kata kunci Skema Cetak publik yang setara. Kata kunci non-standar dalam file GPD atau PPD, namun, dipetakan ke namespace privat khusus perangkat secara default. Anda dapat meningkatkan pemetaan ini dengan melakukan salah satu atau kedua hal berikut:

  • Menentukan namespace privat untuk kata kunci yang tidak biasa.

  • Mengaitkan kata kunci Fitur dan Opsi non-standar dalam file GPD atau PPD dengan kata kunci yang setara dari Skema Cetak publik dalam file GPD atau PPD. Asosiasi ini memungkinkan modul konfigurasi untuk menghasilkan data PrintTicket dan PrintCapabilities sebagai fitur Skema Cetak publik.

Contoh File GPD

Contoh kode berikut menunjukkan file GPD yang mengilustrasikan entri dan kata kunci untuk membuat modul konfigurasi Versi 3 untuk driver cetak 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"  }
}