Funzione EnumICMProfilesA (wingdi.h)

  • Articolo

La funzione EnumICMProfiles enumera i diversi profili di colore di output supportati dal sistema per un determinato contesto del dispositivo.

Sintassi

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Parametri

hdc

Specifica il contesto del dispositivo.

proc

Specifica l'indirizzo dell'istanza di routine di una funzione di callback definita dall'applicazione. Vedere EnumICMProfilesProcCallback.

param

Dati forniti dall'applicazione passata alla funzione di callback insieme alle informazioni sul profilo colore.

Valore restituito

Questa funzione restituisce zero se l'applicazione ha interrotto l'enumerazione. Il valore restituito è -1 se non sono presenti profili di colore da enumerare. In caso contrario, il valore restituito è l'ultimo valore restituito dalla funzione di callback.

Commenti

La funzione EnumICMProfiles restituisce un elenco di profili associati a un contesto di dispositivo (DC) e le cui impostazioni corrispondono a quelle del controller di dominio. È possibile che un contesto del dispositivo contenga profili di dispositivo non associati a dispositivi hardware specifici o profili di dispositivo che non corrispondono alle impostazioni del controller di dominio. Il profilo sRGB è un esempio. La funzione SetICMProfile viene usata per associare questi tipi di profili a un controller di dominio. La funzione GetICMProfile può essere usata per recuperare un profilo non enumerato dalla funzione EnumICMProfiles .

Windows 95/98/Me:EnumICMProfilesW è supportato da Microsoft Layer for Unicode. Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Microsoft Layer for Unicode in Windows 95/98/Me Systems.

Nota

L'intestazione wingdi.h definisce EnumICMProfiles come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche