Export (0) Print
Expand All
Expand Minimize

CMCreateProfile Function

Deprecated. The use of this API is discouraged. The API may be removed from future releases of Windows. For more information, see the Remarks section.

The CMCreateProfile ANSI function creates a display color profile from a LOGCOLORSPACE structure.

Syntax

BOOL WINAPI CMCreateProfile(
    LPLOGCOLORSPACEA lpColorSpace,
    LPBYTE *lpProfileData
);

Parameters

lpColorSpace

Pointer to a color logical space, of which the lcsFilename member will be NULL.

lpProfileData

Pointer to a pointer to a buffer. If successful the function allocates and fills this buffer. It is the calling application's responsibility to free this buffer when it is no longer needed.

Return Value

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.

In Windows 7, the default CMM (icm32.dll) will return FALSE and GetLastError will report ERROR_NOT_SUPPORTED.

Remarks

Deprecated: This function was deprecated in Windows Vista. CMM Implementors are no longer required to implement this method.

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.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wingdi.h

Library

Gdi32.lib

DLL

Icm32.dll

Unicode and ANSI names

CMCreateProfileW (Unicode)

See Also

Basic Color Management Concepts
Functions
CMCreateProfileW

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Community Additions

ADD
Show:
© 2014 Microsoft