Fungsi DrvQueryColorProfile (winddiui.h)

Artikel
02/27/2024

Fungsi DrvQueryColorProfile memungkinkan DLL antarmuka printer menentukan profil ICC untuk digunakan untuk manajemen warna.

Sintaks

BOOL DrvQueryColorProfile(
        HANDLE    hPrinter,
  [in]  PDEVMODEW pdevmode,
        ULONG     ulQueryMode,
  [out] VOID      *pvProfileData,
  [out] ULONG     *pcbProfileData,
  [out] FLONG     *pflProfileData
);

Parameter

hPrinter

Handel printer yang disediakan penelepon.

[in] pdevmode

Penunjuk yang disediakan penelepon ke struktur DEVMODEW .

ulQueryMode

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

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

[out] pvProfileData

Penunjuk yang disediakan penelepon ke buffer untuk menerima informasi profil.

[out] pcbProfileData

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

[out] pflProfileData

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

Bendera	Definisi
QCP_PROFILEDISK	Fungsi ini mengembalikan nama file profil ICC dalam buffer yang ditujukkan oleh pvProfileData.
QCP_PROFILEMEMORY	Fungsi ini mengembalikan data profil dalam buffer yang ditujukkan oleh pvProfileData.

Mengembalikan nilai

Jika operasi berhasil, fungsi mengembalikan TRUE; jika tidak, ia mengembalikan FALSE.

Keterangan

DLL antarmuka printer secara opsional dapat menyediakan fungsi DrvQueryColorProfile. Jika fungsi disediakan, GDI memanggilnya jika ICM telah diaktifkan untuk pekerjaan cetak. Tujuan fungsi ini adalah untuk menentukan dan menentukan profil ICC yang sesuai untuk digunakan dengan pekerjaan cetak.

Jika DLL antarmuka printer driver tidak menyediakan fungsi DrvQueryColorProfile , atau jika fungsi mengembalikan FALSE, GDI mencoba menemukan profil. Untuk informasi selengkapnya, lihat Menemukan Profil ICC.

Jika ukuran buffer output yang ditentukan oleh pcbProfileData terlalu kecil, driver harus menimpa nilai ukuran yang disediakan oleh pcbProfileData dengan ukuran buffer yang diperlukan, panggil SetLastError(ERROR_INSUFFICIENT_BUFFER), dan kembaliKAN FALSE.

Persyaratan

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

Bagikan melalui