Share via

CMCreateProfileW

  • Article

The CMCreateProfileW Unicode function creates a display color profile from a LOGCOLORSPACE structure.

BOOL WINAPI CMCreateProfileW(
  LPLOGCOLORSPACEW lpColorSpace,  // pointer to a color space
  LPBYTE *lpProfileData           // pointer to pointer to buffer
);

Parameters

  • lpColorSpace
    Points to a logical color space, of which the lcsFilename member will be NULL.
  • lpProfileData
    Points to a pointer to a buffer. If successful the function allocates and fills this buffer. The calling application must free this buffer when it is no longer needed. Use the GlobalFree function to free this buffer.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. If the function is not successful, the CMM should call SetLastError to set the last error to a valid error value defined in Winerror.h.

Remarks

The ANSI version of this function is CMCreateProfile.

Only the Windows default CMM is required to export this function; it is optional for all other CMMs. If a CMM does not support CMCreateProfileW, Windows uses the default CMM to create the profile.

The CMM should set all header fields to sensible defaults. This profile should be usable as the input profile in a transform.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Wingdi.h.
**  Library:** Use Gdi32.lib.

See Also

Basic Color Management Concepts, Functions, CMCreateProfile, GlobalFree