[This is preliminary documentation and subject to change.]
The CMCreateProfile ANSI function creates a display color profile from a LOGCOLORSPACE structure.
BOOL WINAPI CMCreateProfile(
LPLOGCOLORSPACEA lpColorSpace, // pointer to a color space
LPBYTE *lpProfileData // pointer to pointer to buffer
);
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.
The Unicode version of this function is CMCreateProfileW.
Only the Windows default CMM is required to export this function; it is optional for all other CMMs.
If a CMM does not support CMCreateProfile, 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.
The calling application must free the buffer allocated by this function and pointed to by the lpProfileData parameter. Use GlobalFree to free the buffer.
Windows NT: Requires version 5.0 or later.
Windows: Requires Windows 98.
Windows CE: Unsupported.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Color Management Overview, ICM 2.0 Functions, CMCreateProfileW