Fungsi GetICMProfileA (wingdi.h)

Artikel
03/08/2023

Fungsi GetICMProfile mengambil nama file profil warna output saat ini untuk konteks perangkat tertentu.

Sintaks

BOOL GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   pszFilename
);

Parameter

hdc

Menentukan konteks perangkat untuk mengambil profil warna.

pBufSize

Penunjuk ke DWORD yang berisi ukuran buffer yang diacu oleh lpszFilename. Untuk versi ANSI dari fungsi ini, ukurannya dalam byte. Untuk versi Unicode, ukurannya ada di WCHAR. Jika fungsi ini berhasil, pada pengembalian parameter ini berisi ukuran buffer yang benar-benar digunakan. Namun, jika buffer tidak cukup besar, fungsi ini mengembalikan FALSE. Dalam hal ini, fungsi GetLastError() mengembalikan ERROR_INSUFFICIENT_BUFFER dan DWORD yang diacu oleh parameter ini berisi ukuran yang diperlukan untuk buffer lpszFilename .

pszFilename

Menunjuk ke buffer yang menerima nama jalur profil.

Nilai kembali

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE. Ini juga mengembalikan TRUE jika parameter lpszFilename adalah NULL dan ukuran yang diperlukan untuk buffer disalin ke dalam lpcbName.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE.

Keterangan

GetICMProfile mendapatkan nama file profil output saat ini terlepas dari apakah manajemen warna diaktifkan atau tidak untuk konteks perangkat.

Mengingat konteks perangkat, GetICMProfile akan menghasilkan, melalui parameter lpszFilename, nama jalur file yang berisi profil warna yang saat ini digunakan oleh konteks perangkat. Ini juga akan menghasilkan, melalui parameter lpcbName, panjang string yang berisi nama jalur.

Ada kemungkinan bahwa nama profil yang dikembalikan oleh GetICMProfile tidak akan ada dalam daftar profil yang dikembalikan oleh EnumICMProfiles. Fungsi EnumICMProfiles mengembalikan semua profil ruang warna yang terkait dengan konteks perangkat (DC) yang pengaturannya cocok dengan DC. Jika fungsi SetICMProfile digunakan untuk mengatur profil saat ini, profil dapat dikaitkan dengan DC yang tidak cocok dengan pengaturannya. Misalnya, fungsi SetICMProfile dapat digunakan untuk mengaitkan profil sRGB independen perangkat dengan DC. Profil ini akan digunakan sebagai profil WCS saat ini untuk DC tersebut, dan panggilan ke GetICMProfile akan mengembalikan nama filenya. Namun, profil tidak akan muncul dalam daftar profil yang dikembalikan dari EnumICMProfiles.

Jika fungsi ini dipanggil sebelum panggilan ke fungsi SetICMProfile , fungsi ini dapat digunakan untuk mendapatkan profil default untuk konteks perangkat.

Windows 95/98/Me: GetICMProfileW didukung oleh Lapisan Microsoft untuk Unicode. Untuk menggunakan ini, Anda harus menambahkan file tertentu ke aplikasi Anda, seperti yang diuraikan dalam Microsoft Layer untuk Unicode pada Sistem Windows 95/98/Me.

Catatan

Header wingdi.h mendefinisikan GetICMProfile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Bagikan melalui