Condividi tramite

Funzione EnumICMProfilesA (wingdi.h)

  • Articolo

La funzione EnumICMProfiles enumera i diversi profili di colore di output supportati dal sistema per un determinato contesto di 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 colore da enumerare. In caso contrario, il valore restituito è l'ultimo valore restituito dalla funzione di callback.

Osservazioni

La funzione EnumICMProfiles restituisce un elenco di profili associati a un contesto di dispositivo e le cui impostazioni corrispondono a quelle del controller di dominio. È possibile che un contesto di 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 dal livello Microsoft per Unicode. Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Livello Microsoft per 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione wingdi.h
libreria Gdi32.lib
dll Gdi32.dll

Vedere anche