C#怎么获取当前屏幕的所有分辨率选项_C#如何列出显示模式【技巧】

首页

编程语言

热心网友

转载

2026-05-06

C#怎么获取当前屏幕的所有分辨率选项_C#如何列出显示模式【技巧】

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

在开发需要适配多显示器或提供显示设置功能的C#应用程序时，获取屏幕支持的所有分辨率选项是一个常见且关键的需求。许多开发者容易混淆两个核心概念：“当前屏幕的实际分辨率”与“显卡驱动支持的所有显示模式”。本文将详细讲解这两种信息的区别，并提供在C#中分别获取它们的正确方法与实用技巧。

核心区别：Screen.AllScreens 仅返回当前已激活的物理显示器及其实际分辨率，无法提供驱动支持的所有可选模式；要枚举显卡驱动中完整的可选分辨率列表，必须通过P/Invoke调用 EnumDisplaySettings 函数，并正确使用 Screen.DeviceName 获取设备名称。

使用 `Screen.AllScreens` 获取当前所有显示器及其实际分辨率

如果你的目标是获取系统中已连接并正在使用的物理屏幕的当前状态信息，那么 System.Windows.Forms.Screen 类提供的 AllScreens 属性是最直接、最稳定的选择。它不依赖于显卡驱动提供的“可选分辨率列表”，仅反映Windows桌面当前实际生效的显示设置，因此在跨不同Windows版本时具有极佳的兼容性。

需要明确的是，Screen.AllScreens 返回的是“当前设置”，而非“所有支持的模式”。它告诉你的是桌面正运行在1920×1080@60Hz，而不是显卡控制面板里那个包含数十种分辨率的下拉菜单。

核心对象与属性：Screen.AllScreens 返回一个 Screen[] 数组。每个 Screen 对象都包含以下关键字段：Bounds（屏幕边界，包含 Width 和 Height）、WorkingArea（工作区，排除了任务栏等系统界面）、Primary（指示是否为主显示器）。
多显示器坐标系统：在多显示器配置下，Bounds 属性表示该屏幕在虚拟桌面坐标系中的矩形位置。例如，若主屏在右侧，副屏在左侧，则副屏的 Bounds.X 值可能为负数。
DPI与缩放陷阱：在未启用DPI感知的应用程序中，如果系统设置了高缩放比例（如150%），Bounds.Size 返回的可能是经过缩放的“逻辑像素”值，而非屏幕的“物理分辨率”。要获取真实的物理分辨率，通常需要配合 Graphics.DpiX/Graphics.DpiY 计算，或直接调用Win32 API查询真实DPI。

使用 `EnumDisplaySettings` 枚举某显示器全部支持的显示模式

要获取显卡驱动设置界面中那个完整的、可供选择的分辨率、刷新率及色深列表，必须调用底层的Windows API。在C#中，这需要通过平台调用（P/Invoke）来访问 user32.dll 中的 EnumDisplaySettings 函数。

此过程中最常见的错误是传入了错误的设备名称参数（lpszDeviceName）。切勿硬编码如 "\\.\DISPLAY1" 这样的字符串。最可靠的做法是从 Screen.AllScreens[i].DeviceName 属性获取系统提供的真实设备名（例如 "\\.\DISPLAY1" 或 "\\.\DISPLAY2"）。

枚举方法与流程：调用 EnumDisplaySettings 时需要循环递增 iModeNum 参数（从0开始），直到函数返回 false，表示所有可用的显示模式已枚举完毕。
关键数据结构：函数会填充一个 DEVMODE 结构体，其中包含核心的显示模式信息：dmPelsWidth 和 dmPelsHeight（分辨率）、dmDisplayFrequency（刷新率，单位Hz）、dmBitsPerPel（每像素位数，即色深）。
模式筛选与判断：返回的列表中，部分模式可能被 dmDisplayFlags 字段中的标志（如 DM_GRAYSCALE 灰度模式或 DM_INTERLACED 隔行扫描模式）标记。这些模式可能已被弃用或当前硬件环境不支持，在实际应用中可能需要过滤。

为什么 `GraphicsAdapter` 不适合用于获取显示模式

部分开发者，尤其是在使用Unity、SharpDX或MonoGame等图形框架时，可能会尝试通过 GraphicsAdapter.AdapterInformation 或类似属性来查询显示模式。需要注意的是，这些类型属于DirectX/DXGI等图形API的抽象层，它们主要反映GPU的“渲染能力”和“支持的输出格式”，而非Windows显示子系统管理并暴露给桌面环境的“可用显示模式”。

简而言之，通过图形API查询无法准确获知当前连接的显示器在Windows设置中能切换到哪些分辨率-刷新率组合，也无法反映显示器EDID（扩展显示标识数据）中定义的物理限制。

一个典型的混淆场景是：在使用Surface Book或通过USB-C扩展坞连接显示器时，GraphicsAdapter.SupportedDisplayModes 可能返回空列表或仅包含默认模式。这是因为底层显示模式的管理由Windows显示驱动模型（WDDM）负责，并未完全通过DXGI的适配器枚举接口暴露。

替代查询途径：如果确实需要从系统管理层面查询显示信息，可以尝试使用WMI（Windows Management Instrumentation）查询 Win32_VideoController 或 Win32_DesktopMonitor 类的属性，但这通常只能获取当前状态，难以得到完整的可选模式列表。
框架演进与兼容性：值得注意的是，在.NET 6及更高版本中，System.Drawing.Common 库在跨平台场景下对 GraphicsAdapter 的支持已被移除或限制，这进一步印证了它并非获取Windows桌面显示模式的标准或推荐途径。

实际代码示例：枚举主显示器所有支持的分辨率模式

理论结合实践，以下提供一个简洁、可运行的C#代码片段，演示如何枚举主显示器的所有显示模式。此示例仅需引用 System.Runtime.InteropServices 和 System.Windows.Forms 命名空间。

[StructLayout(LayoutKind.Sequential)]
public struct DEVMODE
{
    private const int CCHDEVICENAME = 32;
    private const int CCHFORMNAME = 32;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = CCHDEVICENAME)]
public string dmDeviceName;
public short dmSpecVersion;
public short dmDriverVersion;
public short dmSize;
public short dmDriverExtra;
public int dmFields;
public short dmOrientation;
public short dmPaperSize;
public short dmPaperLength;
public short dmPaperWidth;
public short dmScale;
public short dmCopies;
public short dmDefaultSource;
public short dmPrintQuality;
public short dmColor;
public short dmDuplex;
public short dmYResolution;
public short dmTTOption;
public short dmCollate;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = CCHFORMNAME)]
public string dmFormName;
public short dmLogPixels;
public int dmBitsPerPel;
public int dmPelsWidth;
public int dmPelsHeight;
public int dmDisplayFlags;
public int dmDisplayFrequency;
}
[DllImport("user32.dll")]
static extern bool EnumDisplaySettings(string lpszDeviceName, int iModeNum, ref DEVMODE lpDevMode);
// 使用方法：
var primaryScreen = Screen.PrimaryScreen;
var devMode = new DEVMODE { dmSize = (short)Marshal.SizeOf(typeof(DEVMODE)) };
int modeIndex = 0;
Console.WriteLine($"枚举显示器 [{primaryScreen.DeviceName}] 支持的模式：");
while (EnumDisplaySettings(primaryScreen.DeviceName, modeIndex++, ref devMode))
{
    Console.WriteLine($"  分辨率: {devMode.dmPelsWidth} x {devMode.dmPelsHeight}, 刷新率: {devMode.dmDisplayFrequency} Hz, 色深: {devMode.dmBitsPerPel} 位");
}
代码中有几个关键细节：首先，DEVMODE 结构体的 dmSize 字段必须在传递给API前显式赋值为结构体的大小，否则调用会失败。其次，modeIndex 从0开始递增枚举；传入-1可以获取当前活动的模式，但枚举所有模式时通常不需要。
然而，真正的挑战往往不在于成功调用API获取列表，而在于如何判断列表中的哪些模式对当前连接的显示器硬件是实际可用且稳定的。例如，显卡驱动可能报告支持4K@120Hz模式，但当前的HDMI线缆版本、显示器接口或驱动设置可能使其无法正常启用。处理这种复杂性可能需要结合更多API，如使用 MonitorInfoEx 获取显示器能力、解析EDID数据，或者更激进地尝试调用 ChangeDisplaySettingsEx 临时切换模式，并根据返回值判断是否成功。