Fungsi CreateDeviceLinkProfile (icm.h)

Artikel
08/24/2023

Membuat profil tautan perangkat International Color Consortium (ICC) dari serangkaian profil warna, menggunakan niat yang ditentukan.

Sintaks

BOOL CreateDeviceLinkProfile(
  PHPROFILE hProfile,
  DWORD     nProfiles,
  PDWORD    padwIntent,
  DWORD     nIntents,
  DWORD     dwFlags,
  PBYTE     *pProfileData,
  DWORD     indexPreferredCMM
);

Parameter

hProfile

Penunjuk ke array handel profil warna yang akan digunakan. Fungsi ini menentukan apakah HPROFILEs berisi informasi profil ICC dan, jika demikian, ia memprosesnya dengan tepat.

nProfiles

Menentukan jumlah profil dalam array yang ditujukkan oleh hProfile.

padwIntent

Penunjuk ke array DWORDS yang berisi niat yang akan digunakan. Lihat Niat rendering.

nIntents

Jumlah niat dalam array yang diarahkan oleh padwIntent.

dwFlags

Menentukan bendera untuk menggunakan pembuatan kontrol transformasi. Untuk detailnya, lihat Bendera Pembuatan Transformasi CMM.

pProfileData

Penunjuk ke penunjuk ke buffer. Jika berhasil, fungsi ini mengalokasikan buffer, menempatkan alamatnya di *pProfileData, dan mengisinya dengan profil tautan perangkat. Jika fungsi berhasil, aplikasi panggilan harus membebaskan buffer setelah tidak lagi diperlukan.

indexPreferredCMM

Menentukan indeks berbasis satu profil warna yang menunjukkan modul manajemen warna (CMM) apa yang akan digunakan. Pengembang aplikasi dapat mengizinkan Windows untuk memilih CMM dengan mengatur parameter ini ke INDEX_DONT_CARE. Lihat Menggunakan Modul Manajemen Warna (CMM).

Menampilkan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi ini gagal, nilai yang dikembalikan adalah nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk HPROFILEs yang berisi informasi profil WCS, HPROFILEs dikonversi menjadi handel profil ICC yang valid dan kemudian handel profil ICC ini digunakan dalam membuat profil tautan perangkat.

Profil pertama dan terakhir dalam array harus berupa profil perangkat. Profil lainnya dapat berupa ruang warna atau profil abstrak.

Ruang warna output setiap profil harus menjadi ruang warna input profil berikutnya.

Aplikasi panggilan harus membebaskan buffer yang dialokasikan oleh fungsi ini dan ditujukkan oleh parameter pProfileData . Fungsi GlobalFree harus digunakan untuk membebaskan buffer.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	icm.h
Pustaka	Mscms.lib
DLL	Mscms.dll

Bagikan melalui