萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

VB.NET 透過 P/Invoke 設定螢幕解析度、色深與重新率

前言

在 Windows 桌面應用程式中,有時需程式化切換螢幕解析度 (如自動化測試、多媒體播放器)。VB.NET 可透過 P/Invoke 呼叫 Windows API ChangeDisplaySettings 達成。本文整理完整常數、結構與範例程式碼。

必要 API 宣告與常數

Imports System.Runtime.InteropServices

Public Class DisplaySettings
    ' API 宣告
    <DllImport("user32.dll", CharSet:=CharSet.Ansi)>
    Public Shared Function ChangeDisplaySettings(ByRef lpDevMode As DEVMODE, dwFlags As Integer) As Integer
    End Function

    <DllImport("gdi32.dll")>
    Public Shared Function GetDeviceCaps(hdc As IntPtr, nIndex As Integer) As Integer
    End Function

    ' 常數
    Public Const CCDEVICENAME = 32
    Public Const CCFORMNAME = 32
    Public Const DM_BITSPERPEL = &H40000
    Public Const DM_PELSWIDTH = &H80000
    Public Const DM_PELSHEIGHT = &H100000
    Public Const DM_DISPLAYFREQUENCY = &H400000
    Public Const CDS_FORCE = &H80000000
    Public Const BITSPIXEL = 12
    Public Const HORZRES = 8
    Public Const VERTRES = 10
    Public Const VREFRESH = 116

    ' DEVMODE 結構 (對應 Win32 DEVMODE)
    <StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Ansi)>
    Public Structure DEVMODE
        <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=CCDEVICENAME)>
        Public dmDeviceName As String
        Public dmSpecVersion As Short
        Public dmDriverVersion As Short
        Public dmSize As Short
        Public dmDriverExtra As Short
        Public dmFields As Integer
        Public dmOrientation As Short
        Public dmPaperSize As Short
        Public dmPaperLength As Short
        Public dmPaperWidth As Short
        Public dmScale As Short
        Public dmCopies As Short
        Public dmDefaultSource As Short
        Public dmPrintQuality As Short
        Public dmColor As Short
        Public dmDuplex As Short
        Public dmYResolution As Short
        Public dmTTOption As Short
        Public dmCollate As Short
        <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=CCFORMNAME)>
        Public dmFormName As String
        Public dmUnusedPadding As Short
        Public dmBitsPerPel As Short
        Public dmPelsWidth As Integer
        Public dmPelsHeight As Integer
        Public dmDisplayFlags As Integer
        Public dmDisplayFrequency As Integer
    End Structure
End Class

變更解析度範例

Private Sub btnChangeResolution_Click(sender As Object, e As EventArgs) Handles btnChangeResolution.Click
    Dim dm As New DisplaySettings.DEVMODE()
    dm.dmSize = CShort(Marshal.SizeOf(dm))
    dm.dmFields = DisplaySettings.DM_PELSWIDTH Or DisplaySettings.DM_PELSHEIGHT Or DisplaySettings.DM_BITSPERPEL Or DisplaySettings.DM_DISPLAYFREQUENCY
    dm.dmPelsWidth = 1920
    dm.dmPelsHeight = 1080
    dm.dmBitsPerPel = 32
    dm.dmDisplayFrequency = 60

    Dim ret As Integer = DisplaySettings.ChangeDisplaySettings(dm, DisplaySettings.CDS_FORCE)
    If ret <> 0 Then
        MessageBox.Show("變更失敗,不支援該模式。錯誤碼:" & ret)
    Else
        MessageBox.Show("變更成功!")
    End If
End Sub

Private Sub Form_Load(sender As Object, e As EventArgs) Handles MyBase.Load
    Dim hdc As IntPtr = Me.Handle ' 取得裝置內容
    txtOldWidth.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.HORZRES).ToString()
    txtOldHeight.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.VERTRES).ToString()
    txtOldColor.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.BITSPIXEL).ToString()
    txtOldFreq.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.VREFRESH).ToString()
End Sub

注意事項

  • 權限:需管理員權限執行,否則 ChangeDisplaySettings 會失敗 (返回 DISP_CHANGE_FAILED = -1)。
  • 多螢幕:此 API 僅影響主螢幕。多螢幕環境需使用 ChangeDisplaySettingsEx 指定裝置名稱。
  • 永久生效:加上 CDS_UPDATEREGISTRY (&H1) 旗標可寫入登錄,重開機後保持;否則僅暫時生效。
  • 錯誤代碼:常見返回值:0=成功、-1=失敗、-2=模式不支援、-3=重新啟動才生效。

.NET 6+ / Core 適用性

P/Invoke 簽名相同,可直接用於 .NET 6/7/8 Windows Forms 或 WPF 專案,只需確保專案目標框架為 net6.0-windows 等 Windows 專用 TFM。

copyright © 萬盛學電腦網 all rights reserved