Funzione WcsOpenColorProfileA (icm.h)
Crea un handle in un profilo di colore specificato.
Sintassi
HPROFILE WcsOpenColorProfileA(
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 del profilo di colore ICC 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 ICC.
pCAMPProfile
Puntatore a una struttura del profilo che specifica un profilo di aspetto del colore WCS (CAMP). È possibile liberare il puntatore pCAMPProfile dopo aver creato l'handle. Se NULL viene usato il campo predefinito e l'impostazione dell'utente corrente, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, viene usata durante la query sul campo predefinito.
pGMMPProfile
Puntatore a una struttura del profilo che specifica un profilo di mappa di gamut WCS (GMMP). È possibile liberare il puntatore pGMMPProfile dopo aver creato l'handle. Se NULL, viene usato il GMMP predefinito per la finalità di rendering predefinita e l'impostazione utente corrente, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, viene usata durante la query su GMMP predefinita. 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 di colore viene aperto per l'accesso in sola lettura. |
| PROFILE_READWRITE | Specifica che il profilo di 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 di 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 di 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 di 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 non esiste un profilo ICC, WCS crea un nuovo profilo ICC. La funzione avrà esito negativo per i profili WCS se questo flag è impostato e non esiste un profilo WCS. |
| 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 usare il profilo WCS incorporato. Questo parametro non ha effetto a meno che pCDMProfile non specifichi un profilo ICC che contiene un profilo WCS incorporato.
Questo parametro accetta uno dei valori seguenti:
| Valore | Descrizione |
|---|---|
| 0 | Specifica che il profilo WCS incorporato verrà usato e il profilo ICC specificato da pCDMPProfile verrà ignorato. |
| DONT_USE_EMBEDDED_WCS_PROFILES | Specifica che il profilo ICC specificato da pCDMPProfile verrà usato e il profilo WCS incorporato verrà ignorato. |
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è l'handle del profilo di colore aperto.
Se questa funzione ha esito negativo, il valore restituito è NULL.
Commenti
Questa API accetta un set di DMP, CAMP e GMMP e restituirà un handle del profilo WCS. I valori NULL per GMMP sono validi. Un valore NULL per CAMP verrà sostituito con il valore CAMP predefinito.
Questa API accetta anche profili ICC. L'uso di un profilo ICC non garantisce l'elaborazione dal 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 dei profili di 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 ICC viene restituito un HPROFILE ICC 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 al profilo di colore, tutte le informazioni usate per creare tale handle possono essere eliminate.
Utilizzare la funzione CloseColorProfile per chiudere un handle oggetto restituito da WcsOpenColorProfile.
Requisiti
| 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 |