Fungsi GetStandardColorSpaceProfileA (icm.h)
Mengambil profil warna yang terdaftar untuk ruang warna standar yang ditentukan.
Sintaks
BOOL GetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwSCS,
PSTR pBuffer,
PDWORD pcbSize
);
Parameter
pMachineName
Dicadangkan. Harus NULL. Parameter ini dimaksudkan untuk menunjuk ke nama komputer untuk mendapatkan profil ruang warna standar. Penunjuk NULL menunjukkan komputer lokal.
dwSCS
Menentukan nilai ID ruang warna standar untuk mengambil profil. Satu-satunya nilai yang valid untuk parameter ini adalah LCS_sRGB dan LCS_WINDOWS_COLOR_SPACE.
pBuffer
Arahkan ke buffer tempat nama profil akan ditempatkan. Jika NULL, panggilan akan mengembalikan TRUE dan ukuran buffer yang diperlukan ditempatkan dalam pdwSize.
pcbSize
Penunjuk ke variabel yang berisi ukuran dalam byte buffer yang diacu oleh pProfileName. Saat dikembalikan, variabel berisi ukuran buffer yang benar-benar digunakan atau diperlukan.
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 buffer yang ditunjukkan oleh pProfileName dialokasikan secara dinamis oleh aplikasi, aplikasi dapat memanggil fungsi GetStandardColorSpaceProfile untuk mengambil ukuran yang diperlukan untuk buffer. Jika GetStandardColorSpaceProfile dipanggil dengan pProfileName diatur ke NULL, itu akan mengembalikan FALSE dan DWORD yang ditujukkan oleh pdwSize akan berisi jumlah byte yang diperlukan untuk buffer yang ditujukkan oleh pProfileName. Aplikasi kemudian dapat mengalokasikan buffer dan memanggil GetStandardColorSpaceProfile lagi dengan pProfileName diatur ke alamat buffer.
Fungsi ini mendukung profil model perangkat (DMP) Sistem Warna Windows (WCS) selain profil International Color Consortium (ICC). Ini tidak mendukung profil WCS CAMP atau GMMP dan akan mengembalikan kesalahan jika profil tersebut digunakan.
Gambaran Umum Fungsionalitas Spesifik Windows Vista
Ini akan mendukung DMP WCS selain profil ICC. Ini tidak akan mendukung profil WCS CAMP atau GMMP dan akan mengembalikan kesalahan jika profil tersebut digunakan dengan API ini.
Dukungan per pengguna/LUA
Ini akan mengambil profil warna yang terdaftar untuk ruang warna standar yang diberikan untuk pengguna saat ini. Jika tidak ada pengaturan seperti itu untuk pengguna saat ini, pengaturan lebar sistem akan diambil.
Ini menggunakan WcsGetDefaultColorProfile dengan WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Ini dapat dieksekusi dalam konteks LUA.
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 |