GetPS2ColorRenderingIntent

[This is preliminary documentation and subject to change.]

The GetPS2ColorRenderingIntent function retrieves the PostScript Level 2 color rendering intent from a profile.

BOOL WINAPI GetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD dwIntent,
  PBYTE pBuffer,
  PDWORD pcbSize
);
 

Parameters

hProfile

Specifies a handle to the profile in question.

dwIntent

Specifies the desired rendering intent to retrieve. Valid values are:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
 

For more information, see Rendering Intents.

pBuffer

Points to a buffer in which the color rendering intent is to be placed. If the pBuffer pointer is set to NULL, the buffer size required is returned in *pcbSize.

pcbSize

Points to a variable containing the buffer size in bytes. On return, this variable contains the number of bytes actually copied.

Return Values

If this function succeeds, the return value is TRUE. If this function succeeds, the return value is TRUE. It also returns TRUE if the pBuffer parameter is NULL and the size required for the buffer is copied into pcbSize.

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

Remarks

The rendering intent returned by GetPS2ColorRenderingIntent can be used as the operand for the PostScript Level 2 findcolorrendering operator.

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