Windows desktop applications
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

EnumICMProfiles function

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

Syntax


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 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h

Library

Gdi32.lib

DLL

Gdi32.dll

Unicode and ANSI names

EnumICMProfilesW (Unicode) and EnumICMProfilesA (ANSI)

See also

Basic Color Management Concepts
Functions
EnumICMProfilesProcCallback
SetICMProfile
GetICMProfile

 

 

Community Additions

Show:
© 2016 Microsoft