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 函数未枚举的配置文件。

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

注意

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

要求

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

另请参阅