Función WcsOpenColorProfileA (icm.h)
Crea un identificador para un perfil de color especificado.
Sintaxis
HPROFILE WcsOpenColorProfileA(
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 insertado dentro del perfil ICC.
pCAMPProfile
Puntero a una estructura de perfil que especifica un perfil de modelo de apariencia de color WCS (CAMP). 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, mientras se consulta 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 del usuario actual, WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, mientras se consulta el GMMP predeterminado. Para obtener una descripción de las intenciones de representación, consulte Rendering Intents(Intenciones de representación).
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 se abre el perfil de color 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 incluido 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. La función producirá un error en los perfiles WCS si se establece esta marca y no existe un perfil wcs. |
| TRUNCATE_EXISTING | Especifica que el perfil se va a abrir y truncar en cero bytes. Se produce un error en la función si el perfil no existe. |
dwFlags
Valor de marca que especifica si se va a usar el perfil de 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. Un valor NULL para CAMP se reemplazará por el valor predeterminado de CAMP.
Esta API también aceptará perfiles ICC. El uso de un perfil ICC no garantiza el procesamiento por parte del motor DE WCS CITE. 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 de ICC en blanco. Si hay otras marcas dwCreationMode , la función determinará si el perfil es ICC o XML de WCS.
Dentro de la ruta de acceso del código ICC, se devuelve un HPROFILE de ICC mediante las marcas de uso compartido, acceso y creación solicitadas, tal como se especifica en las tablas anteriores.
Dentro de la ruta de acceso de 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 el mismo motivo, 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 para el 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
| 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 |