Fungsi DrvIcmCreateColorTransform (winddi.h)
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.
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) |