Funzione CMCreateProfileW (icm.h)

[CMCreateProfileW non è più disponibile per l'uso a partire da Windows Vista.]

Crea un profilo di colore visualizzato da una struttura LOGCOLORSPACEW .

Sintassi

BOOL CMCreateProfileW(
  LPLOGCOLORSPACEW lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

Parametri

lpColorSpace

Puntatore a uno spazio logico del colore, di cui il membro lcsFilename sarà NULL.

lpProfileData

Puntatore a un puntatore a un buffer. Se la funzione ha esito positivo, alloca e riempie questo buffer. È responsabilità dell'applicazione chiamante liberare questo buffer quando non è più necessario.

Valore restituito

A partire da Windows Vista, il CMM predefinito (Icm32.dll) restituirà FALSE e GetLastError reporterà ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP e Windows 2000:

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Chiamare GetLastError per recuperare l'errore.

Commenti

A partire da Windows Vista, gli implementatori CMM non sono più necessari per implementare questo metodo.

Windows Server 2003, Windows XP e Windows 2000:

La versione Unicode di questa funzione è CMCreateProfileW.

Per esportare questa funzione è necessario solo il CMM predefinito di Windows; è facoltativo per tutte le altre macchine virtuali.

Se un CMM non supporta CMCreateProfileW, Windows usa il CMM predefinito per creare il profilo.

CMM deve impostare tutti i campi di intestazione su valori predefiniti sensibili. Questo profilo deve essere utilizzabile come profilo di input in una trasformazione.

L'applicazione chiamante deve liberare il buffer allocato da questa funzione e puntato al parametro lpProfileData . Usare GlobalFree 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

Vedi anche