C#怎么获取当前屏幕的所有分辨率选项_C#如何列出显示模式【技巧】
C#怎么获取当前屏幕的所有分辨率选项_C#如何列出显示模式【技巧】 在开发需要适配多显示器的C#应用时,一个常见的需求是获取屏幕支持的所有分辨率选项。然而,这里有个关键点需要先厘清:“当前屏幕信息”和“显卡驱动支持的所有模式”是两个不同的概念,获取它们的方法也截然不同。 Screen.AllScre
C#怎么获取当前屏幕的所有分辨率选项_C#如何列出显示模式【技巧】

在开发需要适配多显示器的C#应用时,一个常见的需求是获取屏幕支持的所有分辨率选项。然而,这里有个关键点需要先厘清:“当前屏幕信息”和“显卡驱动支持的所有模式”是两个不同的概念,获取它们的方法也截然不同。
Screen.AllScreens 返回当前激活的物理显示器及其实际分辨率,不提供驱动支持的所有分辨率;EnumDisplaySettings 才能枚举显卡驱动中的全部可选模式,需P/Invoke并用Screen.DeviceName获取正确设备名。
用 Screen.AllScreens 获取当前所有显示器及其分辨率
如果你只是想拿到系统里已经连接并正在使用的物理屏幕信息,那么Screen.AllScreens是最直接、最稳定的选择。它不依赖显卡驱动提供的“可选分辨率列表”,只反映当前实际生效的设置,因此跨Windows版本的兼容性也最好。
不过,这里有个常见的误解:很多人以为Screen.AllScreens能列出“所有支持的分辨率”。其实不然,它返回的仅仅是当前激活的显示模式(比如你桌面正运行在1920×1080@60Hz),而不是显卡设置面板里那个长长的下拉菜单。
- 核心对象:
Screen.AllScreens返回一个Screen[]数组。每个Screen对象都包含了Bounds(内含Width/Height)、WorkingArea(工作区,排除任务栏)、Primary(是否为主屏)等关键字段。 - 多屏坐标:在多显示器场景下,
Bounds表示该屏幕在虚拟桌面坐标系中的矩形位置。如果主屏在右侧,副屏在左侧,那么副屏的Bounds.X可能就是负值。 - DPI陷阱:如果应用程序未启用DPI感知,在高缩放比例(如150%)的屏幕上,
Bounds.Size返回的可能是逻辑像素而非物理像素。要获取真实物理分辨率,通常需要配合GraphicsDeviceCapabilities或直接调用Win32 API来查询真实DPI。
用 EnumDisplaySettings 枚举某显示器全部支持的显示模式
想要拿到显卡驱动设置界面里那个完整的下拉列表?这才是正确的方法。但这条路必须调用Win32 API,并且仅适用于Windows平台。在C#中,我们需要通过P/Invoke来调用user32.dll中的EnumDisplaySettings函数。
这个过程里最容易踩的坑,就是传错了设备名(lpszDeviceName)。千万别想当然地硬编码"\\.\DISPLAY1"。最稳妥的做法是从Screen.AllScreens[i].DeviceName获取真实的设备名(例如"\\.\DISPLAY1"或"\\.\DISPLAY2")。
- 枚举方式:调用
EnumDisplaySettings时需要递增iModeNum参数(从0开始),直到函数返回false,表示所有模式已枚举完毕。 - 关键数据:函数填充的
DEVMODE结构体是关键,其中dmPelsWidth/dmPelsHeight是分辨率,dmDisplayFrequency是刷新率,dmBitsPerPel是色深。 - 模式过滤:返回的列表中,某些模式可能被标记为
DM_DISPLAYFLAGS中的DM_GRAYSCALE(灰度)或DM_INTERLACED(隔行扫描),这些模式可能已弃用或当前硬件不支持,需要额外判断。
为什么 GraphicsAdapter.AdapterInformation 不适合这个需求
有些开发者,尤其是在Unity或SharpDX环境下,会想到去查GraphicsAdapter。但请注意,这个类型属于图形API抽象层(比如DXGI),它返回的是GPU的“渲染能力”,而不是Windows显示子系统暴露给桌面的“显示模式”。
简单来说,它不会告诉你当前连接的显示器是否能切换到2560×1440@120Hz,也无法反映显示器EDID(扩展显示标识数据)中定义的限制。
一个典型的混淆现象:在Surface Book或某些通过USB-C外接的显示器上,GraphicsAdapter.SupportedDisplayModes可能返回空列表或仅包含默认模式。这是因为底层显示模式的管理是由Windows显示驱动模型(WDDM)控制的,并未完全通过DXGI的EnumAdapters逻辑暴露。
- 替代查询:如果真想从硬件层面查询,可以尝试使用WMI查询
Win32_VideoController类的属性(如CurrentHorizontalResolution),但这通常只能得到当前状态,而非所有可选列表。 - 框架演进:值得注意的是,在.NET 6及以上版本中,
System.Drawing.Common库已经移除了对GraphicsAdapter的公开支持,这进一步说明了它并非获取显示模式的标准路径。
实际代码片段:枚举主显示器所有分辨率
理论说再多,不如一段代码来得直观。以下是一个最简可行的示例,它仅依赖System.Runtime.InteropServices和基础的Win32结构体定义:
[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 primary = Screen.PrimaryScreen;
var devMode = new DEVMODE { dmSize = (short)Marshal.SizeOf(typeof(DEVMODE)) };
int modeIndex = 0;
while (EnumDisplaySettings(primary.DeviceName, modeIndex++, ref devMode))
{
Console.WriteLine($"{devMode.dmPelsWidth}x{devMode.dmPelsHeight}@{devMode.dmDisplayFrequency}Hz");
}
代码中有个细节必须注意:dmSize字段必须显式赋值,否则Win32 API调用会失败。另外,modeIndex从0开始递增,而传入-1则可以获取当前活动的模式(不过通常枚举时不需要这个)。
话说回来,真正的难点往往不在于成功调用API并拿到列表,而在于如何判断列表中的哪些模式对当前连接的显示器是实际有效的。例如,你的显卡和驱动可能支持4K@120Hz,但当前的HDMI线缆或显示器接口可能不支持。这时,EnumDisplaySettings依然会返回该模式。要处理这种复杂性,可能需要结合MonitorInfoEx、解析显示器EDID数据,或者更直接一点——尝试调用ChangeDisplaySettings临时切换模式,并根据返回码判断是否成功。
Windows 10 是一款微软推出的经典操作系统,拥有硬件兼容性与多任务处理能力。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
















