Funzione GetColorProfileElement (icm.h)

  • Articolo

Copia i dati da un elemento del profilo con tag specificato di un profilo colore specificato in un buffer.

Sintassi

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

Parametri

hProfile

Specifica un handle per il profilo di colore INTERNATIONAL Color Consortium (ICC) in questione.

tag

Identifica l'elemento con tag da cui copiare.

dwOffset

Specifica l'offset dal primo byte dei dati dell'elemento con tag in corrispondenza del quale iniziare la copia.

pcbElement

Puntatore a una variabile che specifica il numero di byte da copiare. In caso di restituzione, la variabile contiene il numero di byte effettivamente copiati.

pElement

Puntatore a un buffer in cui devono essere copiati i dati dell'elemento con tag. Il buffer deve contenere almeno il numero di byte specificato dalla variabile a cui punta pcbSize. Se il puntatore pBuffer è impostato su NULL, le dimensioni dell'intero dato dell'elemento con tag in byte vengono restituite nella posizione di memoria a cui punta pcbSize e dwOffset viene ignorata. In questo caso, la funzione restituirà FALSE.

pbReference

Punta a un valore booleano impostato su TRUE se più tag nel profilo colore fanno riferimento agli stessi dati del tag specificato oppure false in caso contrario.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

Questa funzione avrà esito negativo se hProfile non è un profilo INTERNATIONAL Color Consortium (ICC) valido.

Se il puntatore pBuffer è impostato su NULL, le dimensioni dell'intero dato dell'elemento con tag in byte vengono restituite nella variabile a cui punta pcbSize e dwOffset viene ignorata.

Questa funzione non supporta i profili WCS (Windows Color System) CAMP, DMP e GMMP; poiché gli elementi del profilo sono associati in modo implicito e hardcoded a, i tipi di tag ICC e esistono molte librerie di analisi XML affidabili.

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