Share via

CMCreateTransformExtW

  • Article

The CMCreateTransformExtW Unicode function creates a color transform that maps from an input LOGCOLORSPACE to an optional target space and then to an output device. A set of flags defines how the transform should be created.

HCMTRANSFORM WINAPI CMCreateTransformExtW(
  LPLOGCOLORSPACEW lpColorSpace,        // color space pointer
  LPDEVCHARACTER lpDevCharacter,        // device profile
  LPDEVCHARACTER lpTargetDevCharacter,  // target profile
  DWORD dwFlags                         // creation flags
);

Parameters

  • lpColorSpace
    Pointer to an input logical color space structure.
  • lpDevCharacter
    Pointer to a memory-mapped device profile.
  • lpTargetDevCharacter
    Points to a memory-mapped target profile.
  • dwFlags
    Specifies flags to used control creation of the transform. For details, see CMM Transform Creation Flags.

Return Values

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 ANSI equivalent of CMCreateTransformExtW is CMCreateTransformExt.

Every CMM is required to export this function.

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, CMCreateTransformExt, LOGCOLORSPACE