Fungsi DrvDocumentPropertySheets (winddiui.h)

Fungsi DrvDocumentPropertySheets antarmuka printer DLL bertanggung jawab untuk membuat halaman lembar properti yang menjelaskan properti dokumen cetak.

Sintaks

LONG DrvDocumentPropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Parameter

[in, optional] pPSUIInfo

Penunjuk yang disediakan penelepon ke struktur PROPSHEETUI_INFO . Bisa NULL (lihat bagian Keterangan berikut).

lParam

Nilai bilangan bulat yang disediakan penelepon yang bergantung pada konten anggota Alasan struktur PROPSHEETUI_INFO, seperti yang tercantum dalam tabel berikut.

Nilai alasan Definisi lParam
PROPSHEETUI_REASON_INIT Penunjuk ke struktur DOCUMENTPROPERTYHEADER .
Semua nilai alasan lainnya Lihat deskripsi parameter lParam untuk jenis fungsi PFNPROPSHEETUI . (Alamat struktur DOCUMENTPROPERTYHEADER terkandung dalam anggota lParamInit dari struktur PROPSHEETUI_INFO .)

Nilai kembali

Jika pPSUIInfoADALAH NULL, dan jika lParam ->fMode nol atau lParam ->pdmOutadalah NULL, fungsi ini harus mengembalikan ukuran, dalam byte, dari struktur DEVMODEW printer. Jika tidak, nilai pengembalian fungsi sama dengan yang dijelaskan di bagian ReturnValue dari jenis fungsi PFNPROPSHEETUI . Untuk informasi selengkapnya, lihat bagian Keterangan.

Keterangan

Semua DLL antarmuka printer harus menyediakan fungsi DrvDocumentPropertySheets , yang didefinisikan menggunakan jenis fungsi PFNPROPSHEETUI . Tujuan fungsi ini adalah untuk memanggil fungsi ComPropSheet , yang disediakan oleh CPSUI, untuk menentukan halaman lembar properti yang berisi properti yang dapat dimodifikasi pengguna untuk mencetak dokumen.

Jika nilai yang diterima untuk parameter pPSUIInfo bukan NULL, penampung cetak sistem operasi berbasis NT memanggil fungsi secara tidak langsung, melalui CPSUI. Aturan berikut ini akan berlaku:

  • Fungsi harus melakukan operasi seperti yang dijelaskan untuk jenis fungsi PFNPROPSHEETUI .

  • Bendera di anggota fMode struktur DOCUMENTPROPERTYHEADER menunjukkan halaman lembar properti mana yang akan ditampilkan dan apakah pengguna harus diizinkan untuk mengubah properti dokumen. Satu-satunya bendera yang mungkin diatur adalah DM_IN_PROMPT (atau DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION, dan DM_OUT_BUFFER (atau DM_COPY).

Jika nilai yang diterima untuk parameter pPSUIInfo adalah NULL, penampung cetak memanggil fungsi secara langsung, tanpa melalui CPSUI. Dalam hal ini, parameter lParam berisi alamat struktur DOCUMENTPROPERTYHEADER, dan aturan berikut berlaku:

  • Jika anggota fMode dari struktur DOCUMENTPROPERTYHEADER adalah nol, atau jika anggota pdmOut dari struktur yang sama adalah NULL, fungsi harus mengembalikan hanya ukuran total struktur DEVMODEW printer, termasuk anggota struktur publik dan privat, dalam anggota cbOut struktur DOCUMENTPROPERTYHEADER.

  • Jika anggota fMode dari struktur DOCUMENTPROPERTYHEADER bukan nol, fungsi harus melakukan operasi yang ditunjukkan oleh bendera fMode . Satu-satunya bendera yang mungkin diatur adalah DM_IN_BUFFER (atau DM_MODIFY), dan DM_OUT_BUFFER (atau DM_COPY).

Persyaratan

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

Lihat juga

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets