Fungsi DrvDriverEvent (winddiui.h)

Artikel
03/01/2024

Penampung cetak memanggil fungsi DrvDriverEvent antarmuka printer DLL ketika penampung memproses peristiwa khusus driver yang mungkin memerlukan tindakan oleh pengandar pencetak.

Sintaks

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

Parameter

dwDriverEvent

Bendera bit yang disediakan penelepon menunjukkan peristiwa yang telah terjadi. Bendera yang valid tercantum dalam tabel berikut.

Bendera	Definisi
DRIVER_EVENT_DELETE	Driver sedang dihapus.
DRIVER_EVENT_INITIALIZE	Driver baru saja diinstal.

dwLevel

Nilai yang disediakan penelepon yang menunjukkan jenis struktur yang ditunjukkan oleh parameter pDriverInfo , seperti yang ditunjukkan dalam tabel berikut.

dwLevel Nilai	Struktur yang ditujukkan oleh pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

Struktur DRIVER_INFO_N dijelaskan dalam dokumentasi Microsoft Windows SDK.

[in, optional] pDriverInfo

Penunjuk yang disediakan penelepon ke struktur yang jenisnya diidentifikasi oleh parameter dwLevel .

lParam

Bendera yang disediakan penelepon. Lihat bagian Keterangan berikut.

Mengembalikan nilai

Jika operasi berhasil, fungsi harus mengembalikan TRUE. Jika tidak, itu harus mengembalikan FALSE.

Keterangan

Fungsi DrvDriverEvent opsional dipanggil oleh fungsi AddPrinterDriverEx dan DeletePrinterDriverEx spooler, yang dijelaskan dalam dokumentasi Windows SDK.

Tujuan fungsi ini adalah untuk memperbolehkan DLL antarmuka pencetak pengandar pencetak melakukan operasi yang diperlukan ketika pengandar diinstal atau dihapus. Operasi umum untuk fungsi ini dilakukan adalah membuat atau menghapus file khusus driver tambahan yang tidak ditentukan sebagai file dependen dalam file INF printer.

Jika dwDriverEvent DRIVER_EVENT_DELETE, parameter lparam berisi bendera yang ditentukan untuk parameter dwDeleteFlag fungsi DeletePrinterDriverEx. Parameter lparam tidak digunakan jika dwDriverEvent DRIVER_EVENT_INITIALIZE.

Karena fungsi DrvDriverEvent dipanggil dalam konteks penampung cetak, fungsi tidak dapat menampilkan antarmuka pengguna.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	winddiui.h (termasuk Winddiui.h)

Bagikan melalui