Funzione GetColorProfileFromHandle (icm.h)

  • Articolo

Dato un handle a un profilo colore aperto, la funzione GetColorProfileFromHandle copia il contenuto del profilo in un buffer fornito dall'applicazione. Se l'handle è un handle WCS (Windows Color System), il DMP viene restituito e il CAMP e GMMP associato a HPROFILE vengono ignorati.

Sintassi

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

Parametri

hProfile

Handle in un profilo colore aperto. La funzione determina se HPROFILE contiene informazioni sul profilo ICC o WCS.

pProfile

Puntatore al buffer per ricevere dati del profilo CP o DMP non elaborati. Può essere NULL. In caso affermativo, le dimensioni necessarie per il buffer verranno archiviate nella posizione di memoria a cui punta pcbSize. Il buffer può essere allocato alle dimensioni appropriate e questa funzione chiamata nuovamente con pBuffer contenente l'indirizzo del buffer.

pcbProfile

Puntatore a un DWORD che contiene le dimensioni del buffer a cui punta pBuffer. Al termine della restituzione, viene riempito con dimensioni del buffer effettivamente usate se la funzione ha esito positivo. Se questa funzione viene chiamata con pBuffer impostato su NULL, questo parametro conterrà le dimensioni del buffer necessarie.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE. Restituisce FALSE se il parametro pBuffer è NULL e le dimensioni necessarie per il buffer vengono copiate in pcbSize.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

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