CreateProfileFromLogColorSpace

[This is preliminary documentation and subject to change.]

The CreateProfileFromLogColorSpace function converts a logical color space to a device profile.

BOOL WINAPI CreateProfileFromLogColorSpace(
  LPLOGCOLORSPACE pLogColorSpace, 
  PBYTE *pBuffer
);
 

Parameters

pLogColorSpace

A pointer to a logical color space structure. See LOGCOLORSPACE for details. The lcsFilename[0] member of the structure must be set to the null character ('\0') or this function call will fail with the return value of INVALID_PARAMETER.

pBuffer

A pointer to a pointer to a buffer where the device profile will be created. This function allocates the buffer and fills it with profile information if it is successful. If not, the pointer is set to NULL. The caller is responsible for freeing this buffer when it is no longer needed.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE.

If the lcsFilename[0] member if the LOGCOLORSPACE structure pointed to by pLogColorSpace is not '\0', this function returns INVALID_PARAMETER.

Remarks

This function can be used with ASCII or Unicode strings. The buffer created by this function must be freed by the caller when it is no longer needed or there will be a memory leak. The GlobalFree function should be used to free this buffer.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, ICM 2.0 Functions, GlobalFree