Bagikan melalui

Fungsi WcsEnumColorProfiles (icm.h)

  • Artikel

Menghitung profil warna yang terkait dengan perangkat apa pun, dalam cakupan yang ditentukan.

Catatan

API ini tidak mendukung profil "warna lanjutan" untuk monitor HDR. Gunakan ColorProfileGetDisplayList untuk mengelola profil warna tingkat lanjut.

Sintaks

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Parameter

scope

Nilai WCS_PROFILE_MANAGEMENT_SCOPE yang menentukan cakupan operasi manajemen profil ini.

pEnumRecord

Penunjuk ke struktur yang menentukan kriteria enumerasi.

pBuffer

Penunjuk ke buffer tempat nama profil akan dijumlahkan. Fungsi WcsEnumColorProfiles menempatkan, dalam buffer ini, string MULTI_SZ yang terdiri dari nama profil yang memenuhi kriteria yang ditentukan dalam *pEnumRecord.

dwSize

Variabel yang berisi ukuran, dalam byte, dari buffer yang diacu oleh pBuffer. Lihat Keterangan.

pnProfiles

Penunjuk opsional ke variabel yang menerima jumlah nama profil yang disalin ke buffer tempat pBuffer menunjuk. Bisa NULL jika informasi ini tidak 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

Gunakan fungsi WcsEnumColorProfilesSize untuk mengambil nilai untuk parameter dwSize , yang merupakan ukuran, dalam byte, dari buffer yang ditunjukkan oleh parameter pBuffer .

Jika parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, hanya asosiasi profil di seluruh sistem ke perangkat yang dipertimbangkan. Jika profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, hanya asosiasi per pengguna untuk pengguna saat ini yang dipertimbangkan. Jika WcsSetUsePerUserProfiles belum pernah dipanggil untuk pengguna ini, atau jika WcsSetUsePerUserProfiles baru-baru ini dipanggil untuk pengguna ini dengan parameter usePerUserProfiles diatur ke FALSE, maka WCSEnumColorProfiles mengembalikan daftar kosong.

Jika WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (pengaturan pengguna saat ini) ada, itu mengambil alih default seluruh sistem untuk parameter profileManagementScope .

Fungsi ini dapat dieksekusi dalam konteks Akun Pengguna (LUA) Least-Privileged.

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

Lihat juga