Compartir a través de

Función WcsOpenColorProfileW (icm.h)

  • Artículo

Crea un identificador para un perfil de color especificado.

Sintaxis

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

Parámetros

pCDMPProfile

Puntero a un DMP de WCS o a una estructura de perfil de color ICC que especifica el perfil. Puede liberar el puntero pCDMPProfile después de crear el identificador. Si el perfil es ICC y su miembro dwType se establece en DONT_USE_EMBEDDED_WCS_PROFILES, WcsOpenColorProfile omite cualquier perfil WCS incrustado dentro del perfil ICC.

pCAMPProfile

Puntero a una estructura de perfil que especifica un perfil de modelo de apariencia de color (CAMP) de WCS. Puede liberar el puntero pCAMPProfile después de crear el identificador. Si es NULL, se usa el CAMP predeterminado y se usa la configuración de usuario actual, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, al consultar el CAMP predeterminado.

pGMMPProfile

Puntero a una estructura de perfil que especifica un perfil de modelo de mapa de gama WCS (GMMP). Puede liberar el puntero pGMMPProfile después de crear el identificador. Si es NULL, se usa el GMMP predeterminado para la intención de representación predeterminada y se usa la configuración de usuario actual, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, al consultar el GMMP predeterminado. Para obtener una descripción de las intenciones de representación, consulte Rendering Intents.

dwDesireAccess

Valor de marca que especifica cómo obtener acceso al perfil de color especificado. Este parámetro debe tomar uno de los siguientes valores:

Valor Descripción
PROFILE_READ Especifica que el perfil de color se abre para el acceso de solo lectura.
PROFILE_READWRITE Especifica que el perfil de color se abre para el acceso de lectura y escritura. El valor de esta marca se omite si el perfil es un perfil WCS.

dwShareMode

Valor de marca que especifica las acciones que se van a realizar al abrir un perfil de color contenido en un archivo. Este parámetro debe tomar uno de los siguientes valores, que se definen en winnt.h:

Valor Descripción
FILE_SHARE_READ Especifica que puede realizar otras operaciones abiertas (para acceso de lectura) en el perfil.
FILE_SHARE_WRITE Especifica que puede realizar otras operaciones abiertas (para el acceso de escritura) en el perfil. Este valor de marca se omite cuando se abre un perfil de WCS.

dwCreationMode

Valor de marca que especifica las acciones que se van a realizar al abrir un perfil de color si está contenido en un archivo. Este parámetro debe tomar uno de los siguientes valores, que se definen en winbase.h:

Valor Descripción
CREATE_NEW Especifica que se crea un nuevo perfil. Esta función produce un error si el perfil ya existe.
CREATE_ALWAYS Especifica que se crea un nuevo perfil. Si ya existe un perfil, se sobrescribe.
OPEN_EXISTING Especifica que se abre el perfil. Esta función produce un error si el perfil no existe.
OPEN_ALWAYS Especifica que el perfil se va a abrir si existe un archivo International Color Consortium (ICC). Si no existe un perfil ICC, WCS crea un nuevo perfil icc. Se producirá un error en la función para los perfiles de WCS si se establece esta marca y no existe un perfil de WCS.
TRUNCATE_EXISTING Especifica que el perfil se va a abrir y truncar a cero bytes. Se produce un error en la función si el perfil no existe.

dwFlags

Valor de marca que especifica si se debe usar el perfil WCS incrustado. Este parámetro no tiene ningún efecto a menos que pCDMProfile especifique un perfil ICC que contenga un perfil WCS incrustado.

Este parámetro toma uno de los siguientes valores:

Valor Descripción
0 Especifica que se usará el perfil WCS incrustado y se omitirá el perfil ICC especificado por pCDMPProfile.
DONT_USE_EMBEDDED_WCS_PROFILES Especifica que se usará el perfil ICC especificado por pCDMPProfile y se omitirá el perfil WCS incrustado.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es el identificador del perfil de color que se abre.

Si se produce un error en esta función, el valor devuelto es NULL.

Comentarios

Esta API tomará un conjunto de DMP, CAMP y GMMP y devolverá un identificador de perfil WCS. Los valores NULL para GMMP son válidos. Se reemplazará un valor NULL para CAMP por el valor de CAMP predeterminado.

Esta API también aceptará perfiles icc. El uso de un perfil ICC no garantiza el procesamiento por parte del motor CITA de WCS. El motor WCS solo se usará si se pasa al menos un perfil de WCS. Los flujos de trabajo de ICC puros serán coherentes con el comportamiento heredado.

Puede usar el identificador que devuelve esta función en otras funciones de administración de perfiles de color.

Las marcas dwCreationMode CREATE_NEW, CREATE_ALWAYS y TRUNCATE_EXISTING siempre devolverán HPROFIL ICC en blanco. Si hay otras marcas dwCreationMode , la función determinará si el perfil es ICC o WCS XML.

Dentro de la ruta de acceso del código ICC, se devuelve un HPROFILE icc utilizando las marcas de uso compartido, acceso y creación solicitadas, tal como se especifica en las tablas anteriores.

Dentro de la ruta de acceso WCS, se producirá un error en la marca dwCreationMode OPEN_ALWAYS si el perfil no existe, ya que los perfiles wcS no se pueden crear ni editar dentro de la arquitectura WCS (deben editarse fuera de él mediante MSXML6). Por la misma razón, la marca dwShareMode FILE_SHARE_WRITE y la marca dwDesiredAccess PROFILE_READWRITE se omiten dentro de la ruta de acceso de WCS.

Una vez creado el identificador del perfil de color, se puede eliminar cualquier información utilizada para crear ese identificador.

Use la función CloseColorProfile para cerrar un identificador de objeto devuelto por WcsOpenColorProfile.

Requisitos

Requisito Value
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

Consulte también