Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CMCreateProfileW function

[CMCreateProfileW is no longer available for use as of Windows Vista.]

Creates a display color profile from a LOGCOLORSPACE structure.

Syntax


BOOL WINAPI CMCreateProfileW(
   LPLOGCOLORSPACEW lpColorSpace,
   LPBYTE           *lpProfileData
);

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 value

Beginning with Windows Vista, the default CMM (Icm32.dll) will return FALSE and GetLastError will report ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP and Windows 2000:  

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

Beginning with Windows Vista, CMM Implementors are no longer required to implement this method.

Windows Server 2003, Windows XP and Windows 2000:  

CMM Implementors are required to implement this method.

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 ANSI version of this function is CMCreateProfile.

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Wingdi.h

Library

Gdi32.lib

DLL

Icm32.dll

See also

Basic Color Management Concepts
Functions
CMCreateProfile
GlobalFree

 

 

Show: