Bagikan melalui

Membangun pengandar printer v4 dasar

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 Cetak v1 dan v2.

Penting

Microsoft telah mengumumkan akhir dukungan layanan untuk driver printer v3 dan v4 lama.

Untuk informasi selengkapnya, lihat Akhir rencana pelayanan untuk driver printer pihak ketiga di Windows.

Peringatan

Tutorial pengandar printer ini berisi beberapa kesalahan dan tidak dapat digunakan saat ini.

Buat driver printer v4 dasar dengan menggunakan wizard pengembangan driver di Microsoft Visual Studio 2019 untuk memilih fitur minimum yang diperlukan untuk menciptakan driver printer fungsional.

Petunjuk dalam topik ini akan berfokus pada langkah-langkah yang diperlukan untuk membangun driver, dan tidak akan menjelaskan berbagai opsi driver printer yang tersedia dalam wizard.

Tujuan dari topik ini adalah untuk memberikan pengenalan proses yang terlibat saat mengembangkan driver printer di Visual Studio 2019.

Tampilan yang lebih rinci tentang opsi driver pencetak disediakan dalam Menjelajahi Opsi Driver pada Wizard.

Prasyarat

Ikuti panduan dalam Mengunduh Windows Driver Kit (WDK) dan pastikan Anda telah menyelesaikan item-item berikut:

  1. Instal Visual Studio 2019 dengan Desktop development with C++ workload dan versi Windows 10 SDK yang benar.

  2. Instal Windows Driver Kit (WDK) untuk Windows 10, versi 2004.

  3. Instal ekstensi Windows Driver Kit (WDK) untuk Visual Studio 2019.

Pilih fitur untuk driver dasar

  1. Di Visual Studio, di menu utama, pilih File>New>Project.

  2. Di jendela Proyek Baru, pada kotak pencarian kanan atas, ketik printer driver v4 dan tekan enter. Ini akan mengambil semua templat driver yang namanya berisi teks pencarian.

  3. Di panel tengah, pilih Driver Printer V4.

  4. Ketik nama untuk driver Anda di bidang Nama , lalu pilih OK. Misalnya, Anda dapat mengetik MyV4PrintDriver.

  5. Di Wizard Buat Driver Cetak v4, di bawah Pilih jenis penyajian driver:, pilih Driver cetak V4 dengan filter penyajian kustom (hanya menerima XPS).

  6. Biarkan semua opsi lain di pengaturan defaultnya dan pilih Berikutnya.

  7. Di bagian Informasi penyetelan pada wizard, biarkan semua opsi pada pengaturan default, lalu pilih Selanjutnya.

  8. Di bagian Informasi penyetelan (halaman 2) wizard, biarkan semua opsi di pengaturan defaultnya, lalu pilih Berikutnya.

Microsoft Visual Studio menggunakan pilihan sebelumnya untuk menghasilkan file proyek untuk MyV4PrintDriver.

Memverifikasi file driver yang dihasilkan

  1. Navigasi ke folder untuk file driver yang dihasilkan. Misalnya, jika Anda menamai proyek MyV4PrintDriver, maka secara default, file akan disimpan ke lokasi berikut: Dokumen > Saya Visual Studio 2019 > Proyek > MyV4PrintDriver > MyV4PrintDriver.

  2. Verifikasi bahwa folder berisi file berikut:

    Nama file Jenis file
    MyV4PrintDriver.gpd File deskripsi printer
    MyV4PrintDriver.inf Menyiapkan file informasi
    MyV4PrintDriver.vcxproj File Proyek C++
    MyV4PrintDriver.vcxproj.filters File filter proyek C++
    MyV4PrintDriver-manifest.ini File pengaturan konfigurasi (manifes pengandar cetak)
    V4PrintDriver-Intellisense.js File JavaScript untuk Intellisense
    V4PrintDriver-Intellisense-Windows8.1.js File JavaScript untuk Intellisense

Perhatikan dari tabel sebelumnya bahwa salah satu file yang dibuat adalah file INF. Perhatikan bahwa Visual Studio membuat file INF kerangka yang harus diselesaikan sehingga dapat digunakan untuk menginstal driver.

Buat PrinterDriverID yang unik untuk driver

  1. Di menu Alat Visual Studio pilih Buat GUID.

  2. Pilih opsi 4. Format Registri dan pilih tombol Salin.

  3. Di Visual Studio, di Penjelajah Solusi, perluas simpul MyV4PrintDriver.

  4. Pilih File Driver, lalu di jendela Properti, lihat nilai untuk bidang Pengidentifikasi Unik. Gantilah nilai ini dengan GUID yang Anda buat menggunakan Tempel.

Lengkapi file INF

Dalam proyek MyV4PrintDriver harus ada entri untuk Driver Files. Buka ini dan file MyV4PrintDriver.inf harus dicantumkan. Buka file ini.

2 baris pertama dari file INF adalah pemberitahuan hak cipta untuk paket driver.

Baris 1 berisi tahun dan nama perusahaan Anda. Ganti karakter YYYY dengan tahun ini dan ganti karakter <Nama produsen Anda> dengan nama perusahaan Anda.

Baris 2 menjelaskan isi INF driver termasuk nama Produsen dan informasi Model perangkat. Ganti karakter <Nama produsen Anda> dengan nama perusahaan Anda dan ganti karakter <Model Printer> dengan nama model printer yang didukung oleh driver.

Misalnya, jika tahun 2021 dan nama perusahaan Anda adalah Fabrikam, dan model perangkat cetak adalah 1234, Anda akan mengetik yang berikut:

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

2. Verifikasi bagian [Versi] sudah benar

Temukan baris yang berisi [Versi].

  • Periksa dan pastikan Anda melihat baris ini:

    ClassVer=4.0

  • Periksa dan pastikan Anda melihat baris ini:

    Signature="$WINDOWS NT$"

3. Konfigurasikan bagian [SourceDisksFiles]

Temukan baris yang berisi [SourceDisksFiles].

Di bawah ini ketik baris berikut:

MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

4. Konfigurasikan bagian [DriverFiles]

Temukan baris yang berisi [DriverFiles].

Di bawah ini ketik baris berikut:

MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

5. Konfigurasikan bagian [Standard.NT$ARCH$]

Temukan baris yang berisi [Standard.NT$ARCH$].

Bagian ini mengacu pada bagian Install dari INF untuk setiap model. Misalnya, jika model printer Anda adalah Fabrikam 1234, maka Anda akan mengetik berikut:

"Fabrikam 1234"=DriverInstall, USBPRINT\\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\\Fabrikam1234

6. Tambahkan PrinterDriverID ke file INF

Di Visual Studio, di Penjelajah Solusi, perluas simpul MyV4PrintDriver.

Pilih Driver Files, lalu di jendela Properti lihat nilai untuk bidang Pengidentifikasi Unik. Ini adalah ID driver (GUID). Sorot dan salin.

Di file INF, di bagian [Standard.NT$ARCH$] , ketik baris berikut:

"Fabrikam 1234"=DriverInstall,

Dan kemudian setelah koma, tempelkan GUID yang Anda salin di langkah sebelumnya. Bagian [Standard.NT$ARCH$] yang telah selesai akan terlihat seperti berikut ini:

"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

7. Konfigurasikan bagian [Strings]

Temukan baris yang berisi [String].

Berikut adalah definisi string ManufacturerName. Ganti karakter <Nama produsen Anda> dengan nama perusahaan Anda untuk memberikan nama produsen untuk printer target dan hapus sisa baris yang berisi ;TODO:

Misalnya, jika nama perusahaan Anda adalah Fabrikam, Anda akan mengetik yang berikut:

ManufacturerName="Fabrikam"

8. Simpan file INF

Saat Anda menyelesaikan file INF, file tersebut akan terlihat seperti berikut ini:

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

[Version]
Signature="$Windows NT$"
Class=Printer
ClassGuid={4D36E979-E325-11CE-BFC1-08002BE10318}
Provider=%ManufacturerName%
CatalogFile=MyV4PrintDriver.cat
ClassVer=4.0
DriverVer=03/17/2014,1.0.0.0
PnpLockdown=1

[Manufacturer]
%ManufacturerName%=Standard,NT$ARCH$

[Standard.NT$ARCH$]
"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

[DriverInstall]
CopyFiles=DriverFiles

[DriverFiles]
MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

[DestinationDirs]
DefaultDestDir = 66000

[SourceDisksNames]
1 = %DiskName%,,,""

[SourceDisksFiles]
MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

[Strings]
ManufacturerName="Fabrikam"
DiskName="MyV4PrintDriver Installation Disk"

Memperbarui daftar File Driver

  1. Di Visual Studio, di Penjelajah Solusi, perluas simpul MyV4PrinterDriver.

  2. Pilih file MyV4PrintDriver.gpd dan seret ke simpul Driver Files.

  3. Lakukan hal yang sama dengan MyV4PrintDriver-manifest.ini.

Tambahkan file Konfigurasi Alur ke paket driver

  1. Di Penjelajah Solusi, pilih dan tahan (atau klik kanan) Proyek MyV4PrintDriver, lalu pilih Properti.

  2. Di jendela Halaman Properti MyV4PrintDriver, kembangkan Properti Konfigurasi di panel kiri.

  3. Perluas Instalasi Driver, lalu pilih Berkas Paket.

  4. Di panel kanan, pilih, lalu klik <baris Edit...> dalam file yang tercantum.

    Pilih file paket, edit baris.

  5. Ganti placeholder dengan jalur relatif file konfigurasi alur, misalnya, ../MyV4PrintDriver Render Filter/MyV4PrintDriverRenderFilter-PipelineConfig.xml, lalu klik OK.

    Ganti placeholder dengan jalur relatif.

Tambahkan referensi filter render ke dalam paket driver

  1. Di Visual Studio, di Penjelajah Solusi, perluas simpul MyV4PrinterDriver.

  2. Pilih dan tahan (atau klik kanan) simpul Referensi -> pilih Tambahkan Referensi.

  3. Pilih kotak centang untuk Filter Render MyV4PrintDriver, lalu pilih OK.

Mengonfigurasi solusi driver untuk debugging dan penyebaran

  1. Di Penjelajah Solusi, pilih dan tahan (atau klik kanan) Proyek MyV4PrintDriver, lalu pilih Properti.

  2. Di jendela Halaman Properti MyV4PrintDriver, kembangkan Properti Konfigurasi di panel kiri.

  3. Perluas Penginstalan Driver, lalu pilih Penerapan. Lakukan hal berikut ini di panel kanan:

    • Pastikan Nama Komputer Target sudah dikonfigurasi. Jika tidak, pilih "..." dan ikuti perintah di wizard Konfigurasi Perangkat untuk menyiapkan komputer target jarak jauh.

    • Periksa Hapus versi driver sebelumnya sebelum penyebaran.

    • Pilih Instal/Instal Ulang dan Verifikasi, lalu pilih Tugas Penginstalan Paket Driver Printer Default dari kotak drop-down.

    • Ketik nama driver di Argumen Opsional (tanpa tanda kutip apa pun di sekitar nama).

    • Pilih OK.

Konfigurasikan penandatanganan driver

  1. Di Penjelajah Solusi, pilih dan tahan (atau klik kanan) Proyek MyV4PrintDriver, lalu pilih Properti.

  2. Di jendela Halaman Properti MyV4PrintDriver, kembangkan Properti Konfigurasi di panel kiri.

  3. Perluas Penandatanganan Driver, lalu pilih Umum.

  4. Di panel kanan, konfirmasikan bahwa Mode Tanda diatur ke Tanda Uji Coba.

  5. Pilih Uji Sertifikat, lalu pilih Buat Sertifikat Uji... dari kotak drop-down.

  6. Pilih TimeStampServer, lalu pilih Verisign dari kotak drop-down.

  7. Pilih OK.

Membangun dan menyebarkan driver

  1. Di Penjelajah Solusi, pilih dan tahan (atau klik kanan) Solusi MyV4PrintDriver (2 proyek), dan pilih Solusi Build.

  2. Ketika proses build selesai, driver akan diinstal secara otomatis. Pastikan bahwa tidak ada kesalahan di jendela Output .

Menguji pengandar

Buat jalur cetak dengan menggunakan plug-and-play atau Wizard Tambah Printer.

Untuk informasi selengkapnya tentang file INF untuk driver printer v4, lihat V4 Driver INF.

Selain file dalam tabel sebelumnya, perhatikan bahwa folder MyV4PrintDriver Render Filter dibuat. Ini adalah templat proyek filter render dan menyediakan fondasi yang baik untuk membangun filter penyajian XPS dan file konfigurasi alur filter XPS. Untuk informasi selengkapnya tentang filter rendering XPS, lihat Modul Penyajian XPSDrv.

  • Last updated on