EnumDisplaySettings功能获取有关显示设备的图形模式之一的信息。您可以通过对此函数进行一系列调用来获取所有显示设备的图形模式的信息。
BOOL EnumDisplaySettings(
| LPCTSTR 【lpszDeviceName】, | //指定显示设备 |
| DWORD【iModeNum】, | //指定图形模式 |
| LPDEVMODE【lpDevMode】 | //指向结构接收设置 |
| ); |
参数
【lpszDeviceName】
指向以空值终止的字符串，指定显示设备，其显示模式的功能将获取有关的信息。
此参数可以为NULL。NULL值指定计算机上正在运行调用线程的当前显示设备。
如果【lpszDeviceName】不为NULL，则该字符串的格式必须为\\\\。\\显示【X】，其中【X】可以具有值1,2或3。
Windows 95： 【lpszDeviceName】必须为NULL。
【iModeNum】
指定要获取信息的图形模式的索引值。
图形模式索引从零开始。要获取所有显示设备图形模式的信息，请进行一系列呼叫EnumDisplaySettings，如下所示：对于第一个呼叫，将【iModeNum】设置为零，并为每个后续呼叫增加【iModeNum】.继续调用函数，直到返回值为FALSE。
当EnumDisplaySettings设置为零时，操作系统将初始化并缓存有关显示设备的信息。当您使用【iModeNum】设置为非零值调用EnumDisplaySettings时，该函数返回上次调用函数时缓存的信息，【iModeNum】设置为零。
【lpDevMode】
指向DEVMODE结构的指针，其中函数存储有关指定图形模式的信息。
EnumDisplaySettings功能为以下五个DEVMODE成员设置值：
dmBitsPerPel
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
如果【iModeNum】大于显示设备的最后一个图形模式的索引，该函数将失败。如【iModeNum】参数的说明中所述，您可以使用此行为枚举所有显示设备的图形模式。
也可以看看
