Fungsi WcsSetDefaultColorProfile (icm.h)
Mengatur nama profil warna default untuk jenis profil yang ditentukan dalam lingkup manajemen profil yang ditentukan.
Catatan
API ini tidak mendukung profil "warna lanjutan" untuk monitor HDR. Gunakan ColorProfileSetDisplayDefaultAssociation untuk mengelola profil warna tingkat lanjut.
Sintaks
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
Parameter
scope
Nilai WCS_PROFILE_MANAGEMENT_SCOPE yang menentukan cakupan operasi manajemen profil ini.
pDeviceName
Penunjuk ke nama perangkat yang profil warna defaultnya akan diatur. Jika NULL, profil default independen perangkat digunakan.
cptColorProfileType
Nilai COLORPROFILETYPE yang menentukan jenis profil warna.
cpstColorProfileSubType
Nilai COLORPROFILESUBTYPE yang menentukan subjenis profil warna.
dwProfileID
ID ruang warna yang diwakili profil warna. Ini adalah nilai ID kustom yang digunakan untuk mengidentifikasi profil ruang warna secara unik dalam aplikasi Anda.
pProfileName
Penunjuk ke buffer yang menyimpan nama profil warna. Lihat Keterangan.
Menampilkan nilai
Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Jika parameter pProfileName adalah NULL dan parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, panggilan berikutnya ke WcsSetDefaultColorProfile akan mengembalikan profil default di seluruh sistem.
Jika profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, fungsi ini dapat dieksekusi dalam konteks Akun Pengguna (LUA) Least-Privileged. Jika tidak, hak istimewa admin diperlukan. Profil yang ditentukan harus sudah diinstal, tetapi mungkin belum dikaitkan dengan perangkat yang ditentukan dalam cakupan manajemen profil yang ditentukan.
Jika profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, fungsi ini tidak akan berfungsi dengan benar jika diluncurkan dari konteks sistem dan bukan Akun Pengguna.
Ketika WcsSetDefaultColorProfile dipanggil untuk mengatur DMP profil model perangkat sebagai profil default untuk RGB atau ruang kerja kustom, hanya profil DMP yang berjenis RGBVirtualDevice, LCD, atau CRT yang valid; yang lain tidak valid.
Ketika WcsSetDefaultColorProfile dipanggil untuk mengatur profil International Color Consortium (ICC) sebagai profil default untuk RGB atau ruang kerja kustom, hanya profil ICC dengan kelas "spac" atau "disp", dan ruang warna "RGB" yang valid; yang lain tidak valid.
Lihat catatan tentang kombinasi jenis/subjenis profil yang valid.
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 |