Función GetColorProfileElement (icm.h)
Copia datos de un elemento de perfil etiquetado especificado de un perfil de color especificado en un búfer.
Sintaxis
BOOL GetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement,
PBOOL pbReference
);
Parámetros
hProfile
Especifica un identificador para el perfil de color international Color Consortium (ICC) en cuestión.
tag
Identifica el elemento etiquetado del que se va a copiar.
dwOffset
Especifica el desplazamiento desde el primer byte de los datos del elemento etiquetado en el que se va a empezar a copiar.
pcbElement
Puntero a una variable que especifica el número de bytes que se van a copiar. Al devolver, la variable contiene el número de bytes realmente copiados.
pElement
Puntero a un búfer en el que se van a copiar los datos del elemento etiquetado. El búfer debe contener al menos tantos bytes como se especifican en la variable a la que apunta pcbSize. Si el puntero pBuffer se establece en NULL, el tamaño de todos los datos de elementos etiquetados en bytes se devuelve en la ubicación de memoria a la que apunta pcbSize y se omite dwOffset . En este caso, la función devolverá FALSE.
pbReference
Apunta a un valor booleano que se establece en TRUE si más de una etiqueta del perfil de color hace referencia a los mismos datos a los que hace referencia la etiqueta especificada o FALSE si no.
Valor devuelto
Si esta función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Esta función producirá un error si hProfile no es un perfil válido de International Color Consortium (ICC).
Si el puntero pBuffer se establece en NULL, el tamaño de todos los datos de elementos etiquetados en bytes se devuelve en la variable a la que apunta pcbSize y se omite dwOffset .
Esta función no admite perfiles del Sistema de colores de Windows (WCS) CAMP, DMP y GMMP; dado que los elementos de perfil están asociados implícitamente y codificados de forma rígida a, los tipos de etiquetas ICC y existen muchas bibliotecas de análisis XML sólidas.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |