Fungsi DrvIcmCreateColorTransform (winddi.h)

Artikel
03/13/2024

Fungsi DrvIcmCreateColorTransform membuat transformasi warna ICM.

Sintaks

HANDLE DrvIcmCreateColorTransform(
  [in]           DHPDEV           dhpdev,
  [in]           LPLOGCOLORSPACEW pLogColorSpace,
  [in, optional] PVOID            pvSourceProfile,
  [in]           ULONG            cjSourceProfile,
  [in]           PVOID            pvDestProfile,
  [in]           ULONG            cjDestProfile,
  [in, optional] PVOID            pvTargetProfile,
  [in]           ULONG            cjTargetProfile,
  [in]           DWORD            dwReserved
);

Parameter

[in] dhpdev

Tangani ke PDEV perangkat fisik.

[in] pLogColorSpace

Penunjuk ke struktur ruang warna logis. Struktur LOGCOLORSPACEW didefinisikan dalam dokumentasi Microsoft Windows SDK. Driver harus mendapatkan informasi ruang warna sumber dari struktur ini ketika pvSourceProfileadalah NULL.

[in, optional] pvSourceProfile

Arahkan ke peta memori profil sumber. Parameter ini bisa NULL.

[in] cjSourceProfile

Menentukan ukuran, dalam byte, dari peta memori profil sumber. Jika pvSourceProfileadalah NULL, parameter ini harus diatur ke nol.

[in] pvDestProfile

Arahkan ke peta memori profil tujuan.

[in] cjDestProfile

Menentukan ukuran, dalam byte, dari peta memori profil tujuan.

[in, optional] pvTargetProfile

Arahkan ke peta memori profil target. Parameter ini bisa NULL.

[in] cjTargetProfile

Menentukan ukuran, dalam byte, dari peta memori profil target. Jika pvTargetProfile adalah NULL, parameter ini harus diatur ke nol.

[in] dwReserved

Parameter yang dipesan yang harus diatur ke nol.

Mengembalikan nilai

DrvIcmCreateColorTransform mengembalikan handel ke transformasi yang dibuat setelah berhasil. Jika tidak, ia melaporkan kesalahan dan mengembalikan NULL.

Keterangan

Driver membuat transformasi warna dari data profil sebagai berikut:

Driver harus menggunakan profil sumber yang dirujuk pvSourceProfile ketika bukan NULL. Jika tidak, driver harus menggunakan data dalam struktur tempat pLogColorSpace menunjuk untuk informasi ruang warna sumber.
Ketika driver menerima profil tujuan tetapi tidak ada profil target, driver harus menyimpan data yang diperlukan untuk mengubah warna dari ruang warna sumber yang ditentukan menjadi ruang warna tujuan yang ditentukan.
Ketika driver menerima profil tujuan dan target, driver harus menyimpan data yang diperlukan untuk mengubah warna dari ruang warna sumber yang ditentukan menjadi ruang warna target yang ditentukan dan dari ruang warna target kembali ke ruang warna tujuan. Dalam skenario ini, perangkat driver adalah perangkat tujuan tempat gambar dapat dibuktikan. Driver kemudian harus dapat mengonversi ruang warna gambar pemeriksa bahasa menjadi ruang warna perangkat target.

Terlepas dari apakah profil target ditentukan, perangkat driver selalu menjadi perangkat tujuan.

Profil yang disediakan mematuhi format profil ICC versi 2.10. Jika driver tidak memahami format yang ditentukan, itu akan gagal panggilan.

Driver dapat dengan aman mengakses seluruh peta memori setiap profil. Pointer pvSourceProfile, pvDestProfile, dan pvTargetProfile hanya berlaku selama cakupan panggilan ke DrvIcmCreateTransform.

Driver yang melaporkan dukungan ICM harus menerapkan fungsi ini. Driver menunjukkan dukungan untuk ICM dengan mengatur bendera GCAPS_ICM di anggota flGraphicsCaps dari struktur DEVINFO .

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	winddi.h (termasuk Winddi.h)

Lihat juga

DrvIcmDeleteColorTransform

Bagikan melalui