Funzione GetICMProfileW (wingdi.h)

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

Sintassi

BOOL GetICMProfileW(
  HDC     hdc,
  LPDWORD pBufSize,
  LPWSTR  pszFilename
);

Parametri

hdc

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

pBufSize

Puntatore a una DWORD contenente le dimensioni del buffer a cui punta da lpszFilename. Per la versione ANSI di questa funzione, le dimensioni sono in byte. Per la versione Unicode, le dimensioni sono in WCHARs. Se questa funzione ha esito positivo, in caso di restituzione di questo parametro contiene le dimensioni del buffer effettivamente usato. Tuttavia, se il buffer non è abbastanza 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 del file del profilo di output corrente indipendentemente dal fatto che la gestione dei colori sia abilitata per il contesto del dispositivo.

Dato un contesto del dispositivo, GetICMProfile verrà restituito, tramite il parametro lpszFilename, il nome del percorso del file contenente il profilo di colore attualmente usato dal contesto del 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 del dispositivo (DC) le cui impostazioni corrispondono a quella del controller di dominio. Se la funzione SetICMProfile viene usata per impostare il profilo corrente, un profilo può essere associato 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 del dispositivo.

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

Requisiti

Vedi anche

• Concetti di base sulla gestione dei colori
• Funzioni
• EnumICMProfilesW
• SetICMProfileW