Funzione GetICMProfileA (wingdi.h)

  • Articolo

La funzione GetICMProfile recupera il nome file del profilo colore di output corrente per un contesto di dispositivo specificato.

Sintassi

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

Parametri

hdc

Specifica un contesto di dispositivo da cui recuperare il profilo colore.

pBufSize

Puntatore a un DWORD contenente le dimensioni del buffer a cui punta lpszFilename. Per la versione ANSI di questa funzione, le dimensioni sono in byte. Per la versione Unicode, le dimensioni sono in WCHAR. Se questa funzione ha esito positivo, in caso di restituzione questo parametro contiene le dimensioni del buffer effettivamente utilizzato. Tuttavia, se il buffer non è sufficientemente grande, questa funzione restituisce FALSE. In questo caso, la funzione GetLastError() restituisce ERROR_INSUFFICIENT_BUFFER e la DWORD a cui punta questo parametro contiene le dimensioni necessarie per il buffer lpszFilename .

pszFilename

Punta al buffer che riceve il nome del percorso del profilo.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE. Restituisce anche TRUE se il parametro lpszFilename è NULL e le dimensioni necessarie per il buffer vengono copiate in lpcbName.

Se questa funzione ha esito negativo, il valore restituito è FALSE.

Commenti

GetICMProfile ottiene il nome file del profilo di output corrente indipendentemente dal fatto che la gestione dei colori sia abilitata per il contesto di dispositivo.

Dato un contesto di dispositivo, Verrà restituito GetICMProfile , tramite il parametro lpszFilename, il nome del percorso del file contenente il profilo colore attualmente usato dal contesto di dispositivo. Verrà inoltre restituito, tramite il parametro lpcbName, la lunghezza della stringa contenente il nome del percorso.

È possibile che il nome del profilo restituito da GetICMProfile non sia incluso nell'elenco dei profili restituiti da EnumICMProfiles. La funzione EnumICMProfiles restituisce tutti i profili di spazio dei colori associati a un contesto di dispositivo (DC) le cui impostazioni corrispondono a quella del controller di dominio. Se la funzione SetICMProfile viene utilizzata per impostare il profilo corrente, è possibile associare un profilo al controller di dominio che non corrisponde alle impostazioni. Ad esempio, la funzione SetICMProfile può essere usata per associare il profilo sRGB indipendente dal dispositivo a un controller di dominio. Questo profilo verrà usato come profilo WCS corrente per tale controller di dominio e le chiamate a GetICMProfile restituiranno il nome del file. Tuttavia, il profilo non verrà visualizzato nell'elenco dei profili restituiti da EnumICMProfiles.

Se questa funzione viene chiamata prima di qualsiasi chiamata alla funzione SetICMProfile , può essere usata per ottenere il profilo predefinito per un contesto di dispositivo.

Windows 95/98/Me: GetICMProfileW è supportato dal livello Microsoft per 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 GetICMProfile 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
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