Share via

EnumICMProfiles

  • Article

The EnumICMProfiles function enumerates the different output color profiles that the system supports for a given device context.

int WINAPI EnumICMProfiles(
  HDC hDC,  ICMENUMPROC lpEnumICMProfilesFunc,  LPARAM lParam );

Parameters

  • hDC
    Specifies the device context.
  • lpEnumICMProfilesFunc
    Specifies the procedure instance address of a callback function defined by the application. (See EnumICMProfilesProcCallback.)
  • lParam
    Data supplied by the application that is passed to the callback function along with the color profile information.

Return Values

This function returns zero if the application interrupted the enumeration. The return value is -1 if there are no color profiles to enumerate. Otherwise, the return value is the last value returned by the callback function.

Remarks

The EnumICMProfiles function returns a list of profiles that are associated with a device context (DC), and whose settings match those of the DC. It is possible for a device context to contain device profiles that are not associated with particular hardware devices, or device profiles that do not match the settings of the DC. The sRGB profile is an example. The SetICMProfile function is used to associate these types of profiles with a DC. The GetICMProfile function can be used to retrieve a profile that is not enumerated by the EnumICMProfiles function.

Windows 95/98/Me: EnumICMProfilesW is supported by the Microsoft Layer for Unicode. To use this, you must add certain files to your application, as outlined in Microsoft Layer for Unicode on Windows 95/98/Me Systems.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Wingdi.h.
**  Library:** Use Gdi32.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows 2000/XP/Vista. Also supported by Microsoft Layer for Unicode.

See Also

Basic Color Management Concepts, Functions, EnumICMProfilesProcCallback, SetICMProfile, GetICMProfile