CreateDeviceLinkProfile

[This is preliminary documentation and subject to change.]

The CreateDeviceLinkProfile function creates a device link profile from a set of color profiles, using the specified intents.

BOOL WINAPI CreateDeviceLinkProfile(
  PHPROFILE pahProfiles,
  DWORD nProfiles,
  PDWORD padwIntent,
  DWORD nIntents,
  DWORD dwFlags,
  PBYTE *pProfileData,
  DWORD indexPreferredCMM 
);
 

Parameters

pahProfiles

Pointer to an array of handles of the color profiles to be used.

nProfiles

Specifies the number of profiles in the array pointed to by pahProfiles.

padwIntent

Pointer to an array of DWORDS containing the intents to be used. See Rendering Intents.

nIntents

The number of intents in the array pointed to by padwIntent.

dwFlags

Specifies flags to control creation of the transform. It is up to the CMM to determine how best to use these flags.

Set the high-order WORD to ENABLE_GAMUT_CHECKING if the transform will be used for gamut checking.

The low-order WORD can have one of the following constant values: PROOF_MODE, NORMAL_MODE, BEST_MODE. Moving from PROOF_MODE to BEST_MODE, output quality generally improves and transform speed declines.

pProfileData

Pointer to a pointer to a buffer. If successful, this function allocates the buffer, places its address in *pProfileData, and fills it with a device link profile. If the function succeeds, the calling application must free the buffer after it is no longer needed.

indexPreferredCMM

Specifies the one-based index of the color profile that indicates which color management module (CMM) to use. If the application developer doesn't care which CMM is used and would like Windows to choose a CMM, it should set this parameter to INDEX_DONT_CARE.

Return Values

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

If this function fails, the return value is zero. For extended error information, call GetLastError.

Remarks

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 pProfileData parameter. The GlobalFree function should be used to free the buffer.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.

See Also

Color Management Overview, ICM 2.0 Functions, GlobalFree