EnumICMProfilesA 函数 (wingdi.h)

EnumICMProfiles 函数枚举系统支持给定设备上下文的不同输出颜色配置文件。

语法

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

参数

hdc

指定设备上下文。

proc

指定应用程序定义的回调函数的过程实例地址。 (请参阅 EnumICMProfilesProcCallback。)

param

由传递给回调函数的应用程序提供的数据以及颜色配置文件信息。

返回值

如果应用程序中断枚举,则此函数返回零。 如果没有要枚举的颜色配置文件,则返回值 -1。 否则,返回值是回调函数返回的最后一个值。

言论

EnumICMProfiles 函数返回与设备上下文(DC)关联的配置文件列表,其设置与 DC 的配置文件匹配。 设备上下文可以包含未与特定硬件设备关联的设备配置文件,或者与 DC 设置不匹配的设备配置文件。 sRGB 配置文件是一个示例。 SetICMProfile 函数用于将这些类型的配置文件与 DC 相关联。 GetICMProfile 函数可用于检索 EnumICMProfiles 函数未枚举的配置文件。

Windows 95/98/Me:Unicode Microsoft 层支持EnumICMProfilesW。 若要使用此功能,必须将某些文件添加到应用程序,如 Windows 95/98/Me 系统上的 Unicode Microsoft 层中所述。

注意

wingdi.h 标头将 EnumICMProfiles 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wingdi.h
Gdi32.lib
DLL Gdi32.dll

另请参阅