EnumICMProfilesA function (wingdi.h)

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

Syntax

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Parameters

hdc

Specifies the device context.

proc

Specifies the procedure instance address of a callback function defined by the application. (See EnumICMProfilesProcCallback.)

param

Data supplied by the application that is passed to the callback function along with the color profile information.

Return value

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

See also

• Basic color management concepts
• Functions
• DeleteColorSpaceW
• ICMENUMPROCA callback function
• GetICMProfileW
• SetICMProfileW