Funzione WcsOpenColorProfileW (icm.h)

  • Articolo

Crea un handle in un profilo colore specificato.

Sintassi

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

Parametri

pCDMPProfile

Puntatore a un DMP WCS o a una struttura di profilo colore CP che specifica il profilo. È possibile liberare il puntatore pCDMPProfile dopo aver creato l'handle. Se il profilo è ICC e il relativo membro dwType è impostato su DONT_USE_EMBEDDED_WCS_PROFILES, WcsOpenColorProfile ignora qualsiasi profilo WCS incorporato all'interno del profilo CPI.

pCAMPProfile

Puntatore a una struttura del profilo che specifica un profilo del modello di aspetto del colore WCS (CAMP). È possibile liberare il puntatore pCAMPProfile dopo aver creato l'handle. Se NULL, viene usato il camp predefinito e l'impostazione utente corrente, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, viene utilizzata durante l'esecuzione di query sul campo predefinito.

pGMMPProfile

Puntatore a una struttura del profilo che specifica un profilo GMMP (WCS Gamut Map Model Profile). È possibile liberare il puntatore pGMMPProfile dopo aver creato l'handle. Se NULL, viene usato il GMMP predefinito per la finalità di rendering predefinita e viene usata l'impostazione utente corrente, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, durante l'esecuzione di query sul gmMP predefinito. Per una descrizione delle finalità di rendering, vedere Finalità di rendering.

dwDesireAccess

Valore del flag che specifica come accedere al profilo di colore specificato. Questo parametro deve accettare uno dei valori seguenti:

Valore Descrizione
PROFILE_READ Specifica che il profilo colore viene aperto per l'accesso in sola lettura.
PROFILE_READWRITE Specifica che il profilo colore viene aperto sia per l'accesso in lettura che in scrittura. Il valore di questo flag viene ignorato se il profilo è un profilo WCS.

dwShareMode

Valore del flag che specifica le azioni da eseguire durante l'apertura di un profilo colore contenuto in un file. Questo parametro deve accettare uno dei valori seguenti, definiti in winnt.h:

Valore Descrizione
FILE_SHARE_READ Specifica che è possibile eseguire altre operazioni aperte (per l'accesso in lettura) nel profilo.
FILE_SHARE_WRITE Specifica che è possibile eseguire altre operazioni aperte (per l'accesso in scrittura) nel profilo. Questo valore del flag viene ignorato quando viene aperto un profilo WCS.

dwCreationMode

Valore del flag che specifica le azioni da eseguire durante l'apertura di un profilo colore se contenuto in un file. Questo parametro deve accettare uno dei valori seguenti, definiti in winbase.h:

Valore Descrizione
CREATE_NEW Specifica che viene creato un nuovo profilo. Questa funzione ha esito negativo se il profilo esiste già.
CREATE_ALWAYS Specifica che viene creato un nuovo profilo. Se esiste già un profilo, viene sovrascritto.
OPEN_EXISTING Specifica che il profilo viene aperto. Questa funzione ha esito negativo se il profilo non esiste.
OPEN_ALWAYS Specifica che il profilo deve essere aperto se esiste un file INTERNATIONAL Color Consortium (ICC). Se un profilo CPI non esiste, WCS crea un nuovo profilo CPI. La funzione avrà esito negativo per i profili WCS se questo flag è impostato e un profilo WCS non esiste.
TRUNCATE_EXISTING Specifica che il profilo deve essere aperto e troncato a zero byte. La funzione ha esito negativo se il profilo non esiste.

dwFlags

Valore del flag che specifica se utilizzare il profilo WCS incorporato. Questo parametro non ha alcun effetto a meno che pCDMProfile non specifichi un profilo CPI che contiene un profilo WCS incorporato.

Questo parametro accetta uno dei valori seguenti:

Valore Descrizione
0 Specifica che verrà usato il profilo WCS incorporato e che il profilo CPI specificato da pCDMPProfile verrà ignorato.
DONT_USE_EMBEDDED_WCS_PROFILES Specifica che verrà usato il profilo CPI specificato da pCDMPProfile e che il profilo WCS incorporato verrà ignorato.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è l'handle del profilo colore aperto.

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

Commenti

Questa API accetta un set di DMP, CAMP e GMMP e restituisce un handle di profilo WCS. I valori NULL per GMMP sono validi. Un valore NULL per CAMP verrà sostituito con il valore CAMP predefinito.

Questa API accetterà anche i profili CPI. L'utilizzo di un profilo CPI non garantisce l'elaborazione da parte del motore CITE WCS. Il motore WCS verrà usato solo se viene passato almeno un profilo WCS. I flussi di lavoro PURE ICC saranno coerenti con il comportamento legacy.

È possibile usare l'handle restituito da questa funzione in altre funzioni di gestione del profilo colore.

I flag dwCreationMode CREATE_NEW, CREATE_ALWAYS e TRUNCATE_EXISTING restituiranno sempre hPROFILES ICC vuoti. Se sono presenti altri flag dwCreationMode , la funzione determinerà se il profilo è ICC o WCS XML.

All'interno del percorso del codice CPI, viene restituito un HPROFILE DI CPI usando i flag di condivisione, accesso e creazione richiesti come specificato nelle tabelle precedenti.

All'interno del percorso WCS, il flag dwCreationMode OPEN_ALWAYS avrà esito negativo se il profilo non esiste, perché i profili WCS non possono essere creati o modificati all'interno dell'architettura WCS (devono essere modificati all'esterno di esso, usando MSXML6). Per lo stesso motivo, il flag dwShareMode FILE_SHARE_WRITE e il flag dwDesiredAccess PROFILE_READWRITE vengono ignorati all'interno del percorso WCS.

Dopo aver creato l'handle per il profilo colore, è possibile eliminare tutte le informazioni usate per creare tale handle.

Utilizzare la funzione CloseColorProfile per chiudere un handle di oggetto restituito da WcsOpenColorProfile.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche