Metode IPrintOemUI::QueryColorProfile (prcomoem.h)

Artikel
08/07/2023

Metode ini IPrintOemUI::QueryColorProfile memungkinkan plug-in antarmuka pengguna untuk menentukan profil ICC yang akan digunakan untuk manajemen warna.

Sintaks

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

Parameter

hPrinter

Handel printer yang disediakan penelepon.

poemuiobj

Penunjuk yang disediakan penelepon ke struktur OEMUIOBJ .

pPublicDM

Penunjuk yang disediakan penelepon ke struktur DEVMODEW yang divalidasi.

pOEMDM

Penunjuk yang disediakan penelepon ke anggota struktur DEVMODEW privat plug-in antarmuka pengguna.

ulQueryMode

Salah satu bendera bit yang disediakan penelepon berikut, menunjukkan jenis profil yang akan ditentukan.

Bendera	Definisi
QCP_DEVICEPROFILE	Penelepon meminta profil perangkat.
QCP_SOURCEPROFILE	Pemanggil meminta profil sumber.

pvProfileData

Penunjuk yang disediakan penelepon ke buffer untuk menerima informasi profil.

pcbProfileData

Penunjuk yang disediakan penelepon ke nilai yang mewakili ukuran, dalam byte, dari buffer yang ditunjukkan oleh pvProfileData.

pflProfileData

Salah satu bendera bit yang disediakan metode berikut, menunjukkan jenis informasi yang dikembalikan metode.

Bendera	Definisi
QCP_PROFILEDISK	Metode ini mengembalikan nama file profil ICC di buffer yang ditujukan oleh pvProfileData.
QCP_PROFILEMEMORY	Metode ini mengembalikan data profil dalam buffer yang diacu oleh pvProfileData.

Mengembalikan nilai

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_FAIL	Operasi gagal.
E_NOTIMPL	Metode ini tidak diterapkan.

Keterangan

Metode plug-in antarmuka pengguna melakukan jenis operasi yang sama dengan fungsi DrvQueryColorProfile yang diekspor IPrintOemUI::QueryColorProfile oleh DLL antarmuka printer mode pengguna. Untuk informasi tentang peristiwa printer dan bagaimana peristiwa tersebut harus diproses, lihat deskripsi fungsi DrvQueryColorProfile .

Jika Anda menyediakan plug-in antarmuka pengguna, fungsi DrvQueryColorProfile driver printer memanggil metode .IPrintOemUI::QueryColorProfile Fungsi DrvQueryColorProfile melakukan pemrosesannya sendiri untuk peristiwa yang ditentukan, lalu memanggil IPrintOemUI::QueryColorProfile metode untuk menangani pemrosesan tambahan peristiwa.

Jika IPrintOemUI::QueryColorProfile metode diekspor oleh beberapa plug-in antarmuka pengguna, metode dipanggil dalam urutan plug-in ditentukan untuk penginstalan.

Untuk informasi selengkapnya tentang membuat dan menginstal plug-in antarmuka pengguna, lihat Menyesuaikan Driver Printer Microsoft.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	prcomoem.h (termasuk Prcomoem.h)

Bagikan melalui