Manifes driver V4
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 Platform cetak modern dan panduan desain aplikasi dukungan Cetak.
Manifes pengandar cetak v4 adalah file teks yang berisi semua direktif penyetelan khusus printer. Manifes pengandar cetak v4 digunakan dengan file INF driver cetak v4, sebagai bagian dari penyetelan untuk pengandar cetak v4 khusus printer.
Arahan dalam manifes diatur ke dalam bagian:
Bagian DriverConfig
Tabel berikut menunjukkan arahan yang digunakan di bagian DriverConfig.
| Direktif | Batasan | Penggunaan |
|---|---|---|
| RequiredFiles Menyertakan file dari ntprint.inf atau ntprint4.inf. Direktif RequiredFiles mendukung nilai berikut di Windows 10: PWGRRenderFilter.dll: Menambahkan filter penyajian Microsoft PWG Raster ke daftar file dependen driver. Filter rendering filter penyajian PWG Raster mengharuskan driver menggunakan file PrintDeviceCapabilities untuk konfigurasi. |
Unidrv.dll, pscript5.dll, dan mxdwdrv.dll harus dihilangkan dari daftar ini. Mereka akan diselesaikan secara otomatis. | Contoh: RequiredFiles= UNIRES.DLL, NAMA STD. GPD, V3HOSTINGFILTER.DLL |
| RequiredClass Menyebabkan driver ini menyertakan semua file dari driver kelas yang ditentukan menggunakan driver/nama yang mudah diingat dari perangkat dan GUID-nya sebagai kunci. Ini adalah mekanisme untuk menautkan driver printclass ke driver tertentu model. |
Arahan RequiredClass tidak dapat digunakan oleh driver kelas. Ketika Anda menggunakan RequiredClass, Anda harus menghindari tabrakan nama file antara driver printer dan driver Kelas Cetak tempat Anda menautkan. Meskipun file dengan nama serupa tidak saling menimpa, mungkin sulit selama pemecahan masalah, untuk membedakan antara file paket driver kelas dan file dari driver printer v4. |
Contoh: RequiredClass= "Fabrikam PCL5e Class Driver",(9343720D-B67E-4451-B93F-6F721C439771) |
| DriverFile Ini menunjuk ke biner penyajian. Mxdwdrv adalah default, tetapi driver kelas dapat menentukan unidrv.dll atau pscript5.dll. Ini secara fungsional identik dengan arahan yang sama dalam INF v3. |
Hanya dapat diatur dalam driver kelas. Pilihan yang valid unidrv.dll atau pscript5.dll. Driver cetak V4 mewarisi dari RequiredClass atau default ke mxdwdrv.dll | DriverFile=unidrv.dll |
| DataFile Ini mendefinisikan GPD utama atau PPD untuk driver ini. Ini secara fungsional identik dengan arahan yang sama dalam INF v3. Di Windows 10, driver cetak v4 dapat terus menentukan GPD atau PPD DataFile, namun, mereka juga dapat menggambarkan DataFile yang dalam format PrintDeviceCapabilities. |
Harus diisi. | Contoh: DataFile=FAPDL.gpd DataFile=FAPDL.xml |
| DataFileType DataFileType harus digunakan saat menjelaskan file PrintDeviceCapabilities sebagai DataFile, dan juga dapat digunakan dengan DataFile berbasis GPD atau PPD juga. |
Diperlukan untuk file PrintDeviceCapabilities. | Contoh: DataFileType= "application/vnd.ms-PrintDeviceCapabilities+xml" |
| Bendera Ini digunakan untuk menentukan atribut opsional yang terkait dengan driver. NotShareable: Bendera ini menentukan bahwa driver tidak dapat dibagikan. Ini sesuai untuk driver virtual seperti Microsoft XPS Document Writer. SoftResetOnJobCancellation: Bendera ini menentukan bahwa perangkat memerlukan pengaturan ulang sementara USB (IOCTL_USBPRINT_SOFT_RESET) pada pembatalan pekerjaan cetak. ArchiveEnabled Driver v4 menggunakan bendera ini untuk meminta XPS yang dioptimalkan arsip sebagai file penampung. |
Tidak ada. | Contoh: Bendera= Tidak dapat dibayangkan, SoftResetOnJobCancellation Bendera= ArchiveEnabled,NotShareable |
| PrinterDriverID Ini adalah ID unik yang menjelaskan pengandar cetak. Jika dua driver menentukan PrinterDriverID yang sama, maka mereka harus kompatibel untuk berbagi dan mendukung ekstensi printer yang sama. |
Harus diisi. | PrinterDriverID= {guid} |
| PropertyBag Menentukan tas properti pengandar untuk pengandar ini. Ini adalah file yang dikompilasi yang dihasilkan oleh DriverPropertyBagTool.exe atau Visual Studio. |
Tidak ada. | PropertyBag= FAProperty.dpb |
| ResourceFile Menentukan nama DLL sumber daya string driver. Di Windows 10, driver dapat menentukan ResourceFile menggunakan format .resx. |
Tidak ada. | Contoh: ResourceFile= FARC.dll |
| ConstraintScript Menentukan nama file batasan JavaScript driver. |
Tidak ada. | ConstraintScript= FAConst.js |
| DriverCategory Menentukan kategori perangkat di antara salah satu dari beberapa opsi. Opsi yang valid adalah sebagai berikut: PrintFax.Fax PrintFax.Printer PrintFax.Printer.3D PrintFax.Printer.File PrintFax.Printer.Service PrintFax.Printer.Virtual |
Harus diisi. | DriverCategory= PrintFax.Printer Untuk informasi selengkapnya tentang kategori driver lainnya, lihat Entri file INF Printer. |
| PrinterExtensionUrl Menentukan URL bagi pengguna untuk mendapatkan salinan aplikasi ekstensi Printer. Digunakan dalam berbagi printer. |
Tidak ada. | PrinterExtensionUrl= "https://www.fabrikam.com/files/setup.exe"; |
| DevModeMap Menentukan file pemetaan Devmode. Ini adalah file XML yang digunakan dengan konversi PrintTicket ke DEVMODE dalam kode JavaScript. |
Tidak ada. | DevModeMap= fadmmap.xml |
| EventFile Menentukan file XML Peristiwa Driver. |
Tidak ada. | EventFile= faevents.xml |
| QueueProperties Menentukan format tas properti antrean. Ini adalah file XML dan TIDAK boleh dikompilasi. |
Tidak ada. | QueueProperties= faQueueProps.xml |
| BidiUSBStatusInterface Menentukan daftar ID perangkat keras yang cocok dengan satu atau beberapa antarmuka perangkat yang akan digunakan untuk komunikasi USB Bidi. |
Tidak ada, tetapi hanya boleh didukung jika status dilakukan melalui antarmuka USB yang bukan antarmuka cetak. | BidiUSBStatusInterface= "USB\vid_1234&pid_1234", "USB\vid_1234&pid_4567" |
| UserPropertyBagScope Arahan ini menentukan cakupan tas properti pengguna sebagai Antrean atau Produsen. Jika direktif ini dihilangkan, maka Antrean adalah nilai default. Opsi yang valid untuk arahan ini adalah sebagai berikut: Antrean: Ini adalah konfigurasi default, dan cocok dengan perilaku Windows 8. Produsen: Semua antrean yang menggunakan string Produsen yang sama dalam INF menggunakan tas properti pengguna yang sama. |
Tidak ada. | UserPropertyBagScope= Produsen |
| RetrievePrintDeviceCapabilitiesFromDevice Driver v4 dapat menentukan bahwa mereka harus mengambil file PrintDeviceCapabilities dari printer WS-Print v2.0, selama mereka mengatur file PrintDeviceCapabilities sebagai DataFile driver dan DataFileType juga menunjukkan bahwa DataFile adalah jenis MIME "application/vnd.ms-PrintDeviceCapabilities+xml". Opsi yang valid: True: Memungkinkan DataFile lokal driver diganti dengan file PrintDeviceCapabilities dari perangkat. False: DataFile lokal driver tidak akan diganti dengan file PrintDeviceCapabilities dari perangkat. Jika tidak ditentukan, nilai default direktif ini adalah false. |
Tidak ada. | Contoh: RetrievePrintDeviceCapabilitiesFromDevice= benar |
Bagian BidiFiles
Bagian BidiFiles digunakan untuk menentukan file ekstensi Bidi. Ini identik dengan format Windows 7 untuk TCP dan WSD. Kata kunci USB baru.
Tabel berikut ini memperlihatkan arahan yang digunakan di bagian BidiFiles.
| Direktif | Batasan | Penggunaan |
|---|---|---|
| BidiSPMFile Ini menentukan file ekstensi Bidi untuk printer berbasis TCP/IP. |
Tidak ada. | BidiSPMFile=FaBidiSPM.xml |
| BidiWSDFile Ini mendefinisikan file ekstensi Bidi untuk printer berbasis WSD. |
Tidak ada. | BidiWSDFile=FABidiWSD.xml |
| BidiUSBFile Ini mendefinisikan ekstensi Bidi untuk USB. |
Tidak ada. | BidiUSBFile=FABidiUSB.xml |
| BidiUSBJSFile Ini menentukan ekstensi JavaScript untuk USB. |
Tidak ada. | BidiUSBJSFile=FABidiUSBJS.js |
Bagian DriverRender
Tabel berikut ini memperlihatkan arahan yang digunakan di bagian DriverRender.
| Direktif | Batasan | Penggunaan |
|---|---|---|
| PageOutputQuality. [OptionName] Mengubah kompresi gambar berdasarkan nilai dalam pekerjaan PrintTicket untuk PageOutputQuality |
OptionName harus berupa nama yang ditentukan dalam namespace layanan PrintSchema standar. | PageOutputQuality.Draft= MxdcImageType.JPEGHigh PageOutputQuality.Normal= MxdcImageType.JPEGMedium PageOutputQuality.High= MxdcImageType.PNG |
| XpsFormat Mengubah format XPS yang dihasilkan oleh sistem cetak untuk driver ini. Beberapa nilai dapat ditentukan, dan urutan mewakili preferensi driver. |
Tidak tersedia untuk digunakan di driver kelas yang menggunakan rendering Unidrv/PScript. | XpsFormat=XPS XpsFormat=OpenXPS XPSFormat=OpenXPS,XPS XPSFormat=XPS,OpenXPS |
| Format Output Arahan OutputFormat menjelaskan satu PDL yang dihasilkan oleh driver ini menggunakan jenis MIME. Informasi ini digunakan selama operasi CreateJob atau CreateJob2 untuk printer WSD. |
Tidak ada. | Jenis penggunaan yang valid meliputi: OutputFormat= "application/oxps" OutputFormat= "application/vnd.ms-xpsdocument" OutputFormat= "image/pwg-raster" OutputFormat= "application/vnd.ms-3mfdocument" Jenis MIME lain yang ditentukan yang valid juga dapat ditentukan di sini. |
Kata kunci MxdcImageType untuk arahan PageOutputQuality memiliki nilai yang diizinkan berikut:
| Nilai MxdcImageType |
|---|
| MxdcImageType.JPEGHigh JPEG kompresi tinggi (file yang lebih kecil) |
| MxdcImageType.JPEGMedium JPEG pemadatan sedang |
| MxdcImageType.JPEGLow JPEG kompresi rendah |
| MxdcImageType.PNG Jenis file PNG (file terbesar) |
Bagian FileSimpan
Bagian ini mendukung skenario penyimpanan file. Ketika driver cetak v4 diinstal terhadap jenis port PORTPROMPT baru, bagian ini menentukan ekstensi file yang akan ditampilkan di jendela File Umum, dan juga menentukan string sumber daya yang dapat dilokalkan yang mendukung ekstensi dan kotak dialog itu sendiri.
| Direktif | Batasan | Penggunaan |
|---|---|---|
| <FileExtensionName> Direktif ini menjelaskan FileExtension yang akan digunakan ketika menyimpan file dari driver ini menggunakan port PORTPROMPT. Nilainya adalah resourceID dari ResourceFile driver. Hanya untuk XPS dan OXPS, resourceID 0 dapat ditentukan dan penampung cetak akan menggunakan sumber daya internalnya untuk ini. |
Tidak ada. | <FileExtensionName>= <resourceID> Xps=1234 |
| SaveAsTitle Direktif ini menjelaskan judul yang akan digunakan pada dialog Simpan File. Nilainya adalah resourceID dari ResourceFile driver. |
Tidak ada. | SaveAsTitle= <resourceID> SaveAsTitle=4321 |
Bagian PrinterExtensions
Bagian PrinterExtensions menentukan ekstensi printer dan mode pemanggilan yang didukungnya. Untuk kedua entri ini, aplikasi akan secara otomatis didaftarkan dengan sistem cetak. Selain itu, aplikasi dikonfigurasi dengan dua parameter berbeda, PrinterDriverID dan ReasonID, dalam urutan tersebut. Akibatnya, setiap entri harus menggunakan GUID PrinterExtensionID yang berbeda.
Tabel berikut menunjukkan arahan yang digunakan di bagian PrinterExtensions.
| Direktif | Batasan | Penggunaan |
|---|---|---|
| DriverEvent Aplikasi yang melayani mode DriverEvent. |
Tidak ada. | DriverEvent= app.exe,{extensionID GUID} |
| PrintPreferences Aplikasi yang melayani mode PrintPreferences. |
Tidak ada. | PrintPreferences= app.exe, {extensionID GUID} |
Berikut ini adalah sampel manifes driver cetak v4.
[DriverConfig]
DataFile=FAPDL.xml
RequiredFiles=UNIRES.DLL,STDNAMES.GPD,STDDTYPE.GDL,STDSCHEM.GDL,STDSCHMX.GDL,XPSSVCS.DLL,MSXPSINC.GPD,PWGRRenderFilter.DLL
ResourceFile=FARC.dll
PropertyBag=FAProperty.dpb
PrinterDriverID={GUID}
DriverCategory=PrintFax.Printer
ConstraintScript=faconst.js
EventFile=faevents.xml
PrinterExtensionUrl="https://www.fabrikam.com/download.asp?uiapp=120"
UserPropertyBagScope=Manufacturer
DataFileType="application/vnd.ms-PrintDeviceCapabilities+xml"
RetrievePrintDeviceCapabilitiesFromDevice=true
[BidiFiles]
BidiSPMFile=FABidiSPM.xml
BidiWSDFile=FABidiWSD.xml
BidiUSBFile=FaBidiUSB.xml
BidiUSBJSFile=FABidiUSBJS.js
[DriverRender]
PageOutputQuality.Draft=MxdcImageType.JPEGHigh
PageOutputQuality.Normal=MxdcImageType.JPEGMedium
PageOutputQuality.High=MxdcImageType.PNG
OutputFormat="image/pwg-raster"
[PrinterExtensions]
DriverEvent=FAapp.exe,{GUID}
PrintPreferences=FAapp.exe,{GUID2}