使用Python win32api实现多显示输出切换的问题求助

核心问题分析 #

当显示设备被标记为“已断开”时，Win32API默认仅枚举活动设备，导致无法直接修改其参数。我们需要绕过这个限制，先强制枚举所有设备，再通过底层API重新激活目标设备。

方案一：用Python调用Windows底层API（ctypes + Win32） #

以下代码可枚举所有显示设备（包括断开状态的），并将指定设备（如\\.\DISPLAY3）设置为唯一活动显示：

import ctypes
from ctypes import wintypes

# 定义Win32结构体和常量
user32 = ctypes.WinDLL('user32', use_last_error=True)

DISPLAY_DEVICE_FLAGS = {
    'EDD_GET_DEVICE_INTERFACE_NAME': 0x00000001
}

class DISPLAY_DEVICE(ctypes.Structure):
    _fields_ = [
        ('cb', wintypes.DWORD),
        ('DeviceName', wintypes.WCHAR * 32),
        ('DeviceString', wintypes.WCHAR * 128),
        ('StateFlags', wintypes.DWORD),
        ('DeviceID', wintypes.WCHAR * 128),
        ('DeviceKey', wintypes.WCHAR * 128)
    ]

class DEVMODE(ctypes.Structure):
    _fields_ = [
        ('dmDeviceName', wintypes.WCHAR * 32),
        ('dmSpecVersion', wintypes.WORD),
        ('dmDriverVersion', wintypes.WORD),
        ('dmSize', wintypes.WORD),
        ('dmDriverExtra', wintypes.WORD),
        ('dmFields', wintypes.DWORD),
        ('dmOrientation', wintypes.SHORT),
        ('dmPaperSize', wintypes.SHORT),
        ('dmPaperLength', wintypes.SHORT),
        ('dmPaperWidth', wintypes.SHORT),
        ('dmScale', wintypes.SHORT),
        ('dmCopies', wintypes.SHORT),
        ('dmDefaultSource', wintypes.SHORT),
        ('dmPrintQuality', wintypes.SHORT),
        ('dmColor', wintypes.SHORT),
        ('dmDuplex', wintypes.SHORT),
        ('dmYResolution', wintypes.SHORT),
        ('dmTTOption', wintypes.SHORT),
        ('dmCollate', wintypes.SHORT),
        ('dmFormName', wintypes.WCHAR * 32),
        ('dmLogPixels', wintypes.WORD),
        ('dmBitsPerPel', wintypes.DWORD),
        ('dmPelsWidth', wintypes.DWORD),
        ('dmPelsHeight', wintypes.DWORD),
        ('dmDisplayFlags', wintypes.DWORD),
        ('dmDisplayFrequency', wintypes.DWORD),
        ('dmICMMethod', wintypes.DWORD),
        ('dmICMIntent', wintypes.DWORD),
        ('dmMediaType', wintypes.DWORD),
        ('dmDitherType', wintypes.DWORD),
        ('dmReserved1', wintypes.DWORD),
        ('dmReserved2', wintypes.DWORD),
        ('dmPanningWidth', wintypes.DWORD),
        ('dmPanningHeight', wintypes.DWORD)
    ]

# 枚举所有显示设备
def enum_display_devices():
    devices = []
    i = 0
    while True:
        dd = DISPLAY_DEVICE()
        dd.cb = ctypes.sizeof(DISPLAY_DEVICE)
        if not user32.EnumDisplayDevicesW(None, i, ctypes.byref(dd), DISPLAY_DEVICE_FLAGS['EDD_GET_DEVICE_INTERFACE_NAME']):
            break
        devices.append(dd)
        i += 1
    return devices

# 设置指定设备为唯一活动显示
def set_single_display(device_name):
    # 获取目标设备的当前模式
    dm = DEVMODE()
    dm.dmSize = ctypes.sizeof(DEVMODE)
    if not user32.EnumDisplaySettingsW(device_name, 0, ctypes.byref(dm)):
        return False

    # 修改模式为仅当前设备显示
    dm.dmFields = 0x00000080 | 0x00000200 | 0x00000001  # DM_PELSWIDTH | DM_PELSHEIGHT | DM_DISPLAYFLAGS
    dm.dmDisplayFlags = 0  # 清除扩展/镜像标志，设为主显示

    # 应用设置（先更新注册表不立即重启，最后统一刷新）
    result = user32.ChangeDisplaySettingsExW(
        device_name,
        ctypes.byref(dm),
        None,
        0x00000001 | 0x00000008,  # CDS_UPDATEREGISTRY | CDS_NORESET
        None
    )

    # 刷新所有显示设置
    user32.ChangeDisplaySettingsExW(None, None, None, 0x00000004, None)  # CDS_RESET
    return result == 0

# 执行切换：找到DISPLAY3并设置为唯一显示
if __name__ == "__main__":
    target_device = r"\\.\DISPLAY3"
    devices = enum_display_devices()
    for dev in devices:
        if dev.DeviceName == target_device:
            print(f"找到目标设备: {dev.DeviceString}")
            success = set_single_display(target_device)
            print("切换成功" if success else "切换失败，需管理员权限")
            break
    else:
        print("未找到目标设备")

注意事项：

• 必须以管理员权限运行脚本，否则无法修改系统显示设置
• dmPelsWidth和dmPelsHeight可根据电视分辨率调整，或用EnumDisplaySettingsW获取最优模式

方案二：调用nircmd工具（快速实现） #

若不想处理复杂API结构体，可使用nircmd轻量命令行工具直接激活断开设备：

1. 下载nircmd并放到系统路径或脚本目录
2. 用Python的subprocess调用命令：

import subprocess

# 切换到仅DISPLAY3显示（分辨率按需调整）
subprocess.run([
    "nircmd.exe",
    "setdisplay",
    "monitor:3",
    "1920", "1080", "32",
    "on",
    "primary"
], check=True)

# 关闭其他显示器（确保仅电视输出）
subprocess.run(["nircmd.exe", "setdisplay", "monitor:1", "off"], check=True)
subprocess.run(["nircmd.exe", "setdisplay", "monitor:2", "off"], check=True)

额外优化建议 #

• 提前缓存电视的最优分辨率和刷新率，避免每次枚举浪费时间
• 给脚本创建快捷方式并设置“以管理员身份运行”，方便快速触发切换

内容的提问来源于stack exchange，提问作者Lukáš Hájek