Windows desktop applications
Collapse the table of content
Expand the table of content
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.

CMCreateDeviceLinkProfile function

The CMCreateDeviceLinkProfile function creates a device link profile in the format specified by the International Color Consortium in its ICC Profile Format Specification.

Syntax


BOOL WINAPI CMCreateDeviceLinkProfile(
  LPHPROFILE lpahProfiles,
  DWORD nProfiles,
  PDWORD padwIntents,
  DWORD nIntents,
  DWORD dwFlags,
  LPBYTE *lpProfileData
);

Parameters

lpahProfiles

Pointer to an array of profile handles.

nProfiles

Specifies the number of profiles in the array.

padwIntents

An array of rendering intents.

nIntents

The number of elements in the array of intents.

dwFlags

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

lpProfileData

Pointer 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

If the function succeeds, the return value is a nonzero value.

If this function fails, the return value is zero. 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

Only the Windows default CMM is required to export this function; it is optional for all other CMMs.

If a CMM does not support CMCreateDeviceLinkProfile, Windows uses the default CMM to create a device link profile.

The first and the last profiles in the array must be device profiles. The other profiles can be color space or abstract profiles. Each profile's output color space must be the next profile's input color space.

The calling application must free the buffer allocated by this function and pointed to by the lpProfileData parameter. Use the GlobalFree function to free the buffer.

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

See also

Basic Color Management Concepts
Functions
GlobalFree

 

 

Community Additions

Show:
© 2016 Microsoft