Compartir a través de

Función GetColorProfileFromHandle (icm.h)

  • Artículo

Dado un identificador a un perfil de color abierto, la función GetColorProfileFromHandle copia el contenido del perfil en un búfer proporcionado por la aplicación. Si el identificador es un controlador del Sistema de colores de Windows (WCS), se devuelve el DMP y se omiten camp y GMMP asociados con el HPROFILE.

Sintaxis

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

Parámetros

hProfile

Identificador de un perfil de color abierto. La función determina si el HPROFILE contiene información de perfil ICC o WCS.

pProfile

Puntero al búfer para recibir datos de perfil de ICC o DMP sin procesar. Puede ser NULL. Si es así, el tamaño necesario para el búfer se almacenará en la ubicación de memoria a la que apunta pcbSize. El búfer se puede asignar al tamaño adecuado y esta función llama de nuevo con pBuffer que contiene la dirección del búfer.

pcbProfile

Puntero a un DWORD que contiene el tamaño del búfer al que apunta pBuffer. Al devolverlo, se rellena con el tamaño del búfer que se usó realmente si la función se realiza correctamente. Si se llama a esta función con pBuffer establecido en NULL, este parámetro contendrá el tamaño del búfer necesario.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE. Devuelve FALSE si el parámetro pBuffer es NULL y el tamaño necesario para el búfer se copia en pcbSize.

Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

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

Consulte también