Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 2.5 KB

nf-icm-cmgetps2colorrenderingintent.md

File metadata and controls

87 lines (65 loc) · 2.5 KB
Raw
UID title description tech.root ms.date targetos req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs
NF:icm.CMGetPS2ColorRenderingIntent
CMGetPS2ColorRenderingIntent
Retrieves the PostScript Level 2 color [rendering intent](/windows/win32/wcs/r) from a profile.
wcs
02/01/2021
Windows
function
icm.h
Windows 2000 Professional \[desktop apps only\]
Windows 2000 Server \[desktop apps only\]
apiref
icm.h
CMGetPS2ColorRenderingIntent
CMGetPS2ColorRenderingIntent
icm/CMGetPS2ColorRenderingIntent
c++

-description

Retrieves the PostScript Level 2 color rendering intent from a profile.

-parameters

-param hProfile

Specifies the profile to use.

-param dwIntent

Specifies the desired rendering intent to retrieve. Can be one of the following values:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering Intents.

-param lpBuffer

Points to a buffer in which the color rendering intent is to be placed. If the pointer is NULL, the function returns the size required for this buffer in *lpcbSize.

-param lpcbSize

Points to a variable specifying the size of the buffer. On return, the variable contains has the number of bytes actually copied to the buffer.

-returns

If this function succeeds, the return value is TRUE. It also returns TRUE if it is called with lpBuffer set to NULL and the size of the required buffer is copied into lpcbSize.

If this function fails, the return value is FALSE. When this occurs, the CMM should call SetLastError to set the last error to a valid error value defined in Winerror.h.

-remarks

This function is optional for all CMMs.

If a CMM does not support this function, Windows uses the default CMM to get the color rendering intent.

If the tag is not present in the profile indicated by hProfile, the CMM creates it. The resulting rendering intent can be used as the operand for the PostScript Level 2 findcolorrendering operator.

-see-also