Funzione CreateDeviceLinkProfile (icm.h)

  • Articolo

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

Vedi anche