Windows Dev Center

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.

CMCreateTransformExt function

The CMCreateTransformExt ANSI function creates a color transform that maps from an input LOGCOLORSPACE to an optional target space and then to an output device, using a set of flags that define how the transform should be created.

Syntax


HCMTRANSFORM WINAPI CMCreateTransformExt(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER lpDevCharacter,
  LPDEVCHARACTER lpTargetDevCharacter,
  DWORD dwFlags
);

Parameters

lpColorSpace

Pointer to an input logical color space structure.

lpDevCharacter

Pointer to a memory-mapped device profile.

lpTargetDevCharacter

Pointer to a memory-mapped target profile.

dwFlags

Specifies flags to used control creation of the transform. For details, see CMM Transform Creation Flags.

Return value

If this function succeeds, the return value is a color transform in the range 256 to 65,535. Since only the low WORD of the transform is retained, valid transforms cannot exceed this range.

If this function fails, the return value is an error code having a value less than 256. When the return value is less than 256, signaling an error, the CMM should use SetLastError to set the last error to a valid error value as defined in Winerror.h.

Remarks

The Unicode equivalent of CMCreateTransformExt is CMCreateTransformExtW.

Every CMM is required to export this function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h

Library

Gdi32.lib

DLL

Icm32.dll

Unicode and ANSI names

CMCreateTransformExtW (Unicode)

See also

Basic Color Management Concepts
Functions
CMCreateTransformExtW

 

 

Community Additions

Show:
© 2015 Microsoft