EnumICMProfiles

[This is preliminary documentation and subject to change.]

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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, ICM 2.0 Functions, EnumICMProfilesProcCallback, SetICMProfile, GetICMProfile