Bagikan melalui

Fungsi GetColorProfileElement (icm.h)

  • Artikel

Menyalin data dari elemen profil yang diberi tag tertentu dari profil warna tertentu ke dalam buffer.

Sintaks

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

Parameter

hProfile

Menentukan handel ke profil warna International Color Consortium (ICC) yang dimaksud.

tag

Mengidentifikasi elemen yang diberi tag untuk disalin.

dwOffset

Menentukan offset dari byte pertama dari data elemen yang ditandai untuk mulai menyalin.

pcbElement

Penunjuk ke variabel yang menentukan jumlah byte yang akan disalin. Saat dikembalikan, variabel berisi jumlah byte yang benar-benar disalin.

pElement

Penunjuk ke buffer tempat data elemen yang ditandai akan disalin. Buffer harus berisi setidaknya sebanyak byte seperti yang ditentukan oleh variabel yang diacu oleh pcbSize. Jika penunjuk pBuffer diatur ke NULL, ukuran seluruh data elemen yang ditandai dalam byte dikembalikan di lokasi memori yang diarahkan oleh pcbSize, dan dwOffset diabaikan. Dalam hal ini, fungsi akan mengembalikan FALSE.

pbReference

Menunjuk ke nilai Boolean yang diatur ke TRUE jika lebih dari satu tag di profil warna mengacu pada data yang sama dengan tag yang ditentukan mengacu pada, atau FALSE jika tidak.

Menampilkan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi ini akan gagal jika hProfile bukan profil International Color Consortium (ICC) yang valid.

Jika penunjuk pBuffer diatur ke NULL, ukuran seluruh data elemen yang ditandai dalam byte dikembalikan dalam variabel yang diarahkan oleh pcbSize, dan dwOffset diabaikan.

Fungsi ini tidak mendukung profil Windows Color System (WCS) CAMP, DMP, dan GMMP; karena elemen profil secara implisit dikaitkan dengan, dan dikodekan secara permanen, jenis tag ICC dan ada banyak pustaka penguraian XML yang kuat.

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