Bagikan melalui

Fungsi GetICMProfileA (wingdi.h)

  • Artikel

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

Sintaksis

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 ditujukkan 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 ditujukkan oleh parameter ini berisi ukuran yang diperlukan untuk buffer lpszFilename .

pszFilename

Arahkan ke buffer yang menerima nama jalur profil.

Mengembalikan nilai

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

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE.

Komentar

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 berada 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 Microsoft Layer for Unicode. Untuk menggunakan ini, Anda harus menambahkan file tertentu ke aplikasi Anda, seperti yang diuraikan dalam Microsoft Layer for Unicode pada Windows 95/98/Me Systems.

Nota

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

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

Lihat juga