enumDisplaySettingsA 函数 (winuser.h)

项目
08/27/2023

EnumDisplaySettings 函数检索显示设备图形模式之一的相关信息。若要检索显示设备的所有图形模式的信息，请对此函数进行一系列调用。

注意你设计为面向 Windows 8 及更高版本的应用无法再查询或设置小于每像素 32 位的显示模式， (bpp) ;这些操作将失败。这些应用具有面向 Windows 8 的兼容性清单。对于在没有 Windows 8 清单的情况下生成的桌面应用，Windows 8 仍支持 8 位和 16 位颜色模式;Windows 8 模拟这些模式，但仍在 32 位颜色模式下运行。

语法

BOOL EnumDisplaySettingsA(
  [in]  LPCSTR   lpszDeviceName,
  [in]  DWORD    iModeNum,
  [out] DEVMODEA *lpDevMode
);

参数

[in] lpszDeviceName

指向以 null 结尾的字符串的指针，该字符串指定有关函数将获取其图形模式信息的显示设备。

此参数为 NULL 或DISPLAY_DEVICE。从 EnumDisplayDevices 返回的 DeviceName。 NULL 值指定运行调用线程的计算机上的当前显示设备。

[in] iModeNum

要检索的信息的类型。此值可以是图形模式索引或以下值之一。

值	含义
ENUM_CURRENT_SETTINGS	检索显示设备的当前设置。
ENUM_REGISTRY_SETTINGS	检索当前存储在注册表中的显示设备的设置。

图形模式索引从零开始。若要获取显示设备的所有图形模式的信息，请对 EnumDisplaySettings 进行一系列调用，如下所示：将 iModeNum 设置为第一次调用的零，并为每个后续调用增加 iModeNum 1。继续调用函数，直到返回值为零。

在 iModeNum 设置为零的情况下调用 EnumDisplaySettings 时，操作系统将初始化并缓存有关显示设备的信息。调用 EnumDisplaySettings 且 iModeNum 设置为非零值时，函数将返回上次调用该函数时缓存的信息，并将 iModeNum 设置为零。

[out] lpDevMode

指向 DEVMODE 结构的指针，函数在其中存储有关指定图形模式的信息。在调用 EnumDisplaySettings 之前，请将 dmSize 成员设置为 sizeof(DEVMODE)，并将 dmDriverExtra 成员设置为指示可用于接收专用驱动程序数据的额外空间的大小（以字节为单位）。

EnumDisplaySettings 函数为以下五个 DEVMODE 成员设置值：

dmBitsPerPel
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注解

如果 iModeNum 大于显示设备最后一个图形模式的索引，则函数将失败。如 iModeNum 参数的说明中所述，可以使用此行为枚举显示设备的所有图形模式。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。给定的输出始终以物理像素为单位，与调用上下文无关。

注意

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

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	windows 8 中引入的 ext-ms-win-ntuser-sysparams-ext-l1-1-0 ()