Funzione CreateDeviceLinkProfile (icm.h)
Crea un profilo di collegamento del dispositivo INTERNATIONAL Color Consortium (ICC) da un set di profili colore, usando le finalità specificate.
Sintassi
BOOL CreateDeviceLinkProfile(
PHPROFILE hProfile,
DWORD nProfiles,
PDWORD padwIntent,
DWORD nIntents,
DWORD dwFlags,
PBYTE *pProfileData,
DWORD indexPreferredCMM
);
Parametri
hProfile
Puntatore a una matrice di handle dei profili di colore da utilizzare. La funzione determina se gli HPROFILEs contengono informazioni sul profilo ICC e, in tal caso, li elabora in modo appropriato.
nProfiles
Specifica il numero di profili nella matrice a cui punta hProfile.
padwIntent
Puntatore a una matrice di DWORDS contenente le finalità da usare. Vedere Finalità di rendering.
nIntents
Numero di finalità nella matrice a cui punta padwIntent.
dwFlags
Specifica i flag per utilizzare la creazione del controllo della trasformazione. Per informazioni dettagliate, vedere Flag di creazione della trasformazione CMM.
pProfileData
Puntatore a un puntatore a un buffer. In caso di esito positivo, questa funzione alloca il buffer, inserisce l'indirizzo in *pProfileData e lo riempie con un profilo di collegamento del dispositivo. Se la funzione ha esito positivo, l'applicazione chiamante deve liberare il buffer dopo che non è più necessario.
indexPreferredCMM
Specifica l'indice in base uno del profilo colore che indica il modulo di gestione dei colori (CMM) da usare. Lo sviluppatore di applicazioni può consentire a Windows di scegliere CMM impostando questo parametro su INDEX_DONT_CARE. Vedere Uso dei moduli di gestione dei colori (CMM).
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se questa funzione ha esito negativo, il valore restituito è zero. Per informazioni sugli errori estesi, chiamare GetLastError.
Commenti
Per gli HPROFILEs che contengono informazioni sul profilo WCS, gli HPROFILEs vengono convertiti in handle di profilo ICC validi e quindi questi handle di profilo CPI vengono usati per creare il profilo di collegamento del dispositivo.
Il primo e l'ultimo profilo nella matrice devono essere profili di dispositivo. Gli altri profili possono essere spazi dei colori o profili astratti.
Lo spazio colore di output di ogni profilo deve essere lo spazio colore di input del profilo successivo.
L'applicazione chiamante deve liberare il buffer allocato da questa funzione e fare riferimento al parametro pProfileData . La funzione GlobalFree deve essere usata per liberare il buffer.
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 |