SetProcessDpiAwarenessContext调用返回false问题排查求助

我有一个DPI感知无关（DPI unaware）的应用程序，希望通过编程方式告知操作系统该状态。

我使用的P/Invoke代码如下：

[DllImport("user32.dll", SetLastError = true)]
internal static extern bool SetProcessDpiAwarenessContext(int dpiFlag);

[DllImport("SHCore.dll", SetLastError = true)]
internal static extern bool SetProcessDpiAwareness(PROCESS_DPI_AWARENESS awareness);

[DllImport("user32.dll")]
internal static extern bool SetProcessDPIAware();

public enum PROCESS_DPI_AWARENESS
{
    Process_DPI_Unaware = 0,
    Process_System_DPI_Aware = 1,
    Process_Per_Monitor_DPI_Aware = 2
}

public enum DPI_AWARENESS_CONTEXT
{
    DPI_AWARENESS_CONTEXT_UNAWARE = 16,
    DPI_AWARENESS_CONTEXT_SYSTEM_AWARE = 17,
    DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = 18,
    DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 = 34
}

实现的设置方法：

public static void SetDpiAwareness()
{
    if (Environment.OSVersion.Version >= new Version(6, 3, 0)) // win 8.1 added support for per monitor dpi
    {
        if (Environment.OSVersion.Version >= new Version(10, 0, 15063)) // win 10 creators update added support for per monitor v2
        {
            var r = NativeMethods.SetProcessDpiAwarenessContext((int) NativeMethods.DPI_AWARENESS_CONTEXT.DPI_AWARENESS_CONTEXT_UNAWARE);
        }
        else
        {
            NativeMethods.SetProcessDpiAwareness(NativeMethods.PROCESS_DPI_AWARENESS.Process_DPI_Unaware);
        }
    }
}

我在程序初始化日志后立即调用了SetDpiAwareness方法，但SetProcessDpiAwarenessContext的返回值始终为false，且渲染效果显示调用未生效。请问可能是什么原因？

1. DPI感知上下文枚举值错误 #

你的DPI_AWARENESS_CONTEXT枚举定义完全错误，Windows系统中这些上下文的实际值是基于负数的指针常量，而非正数：

• DPI_AWARENESS_CONTEXT_UNAWARE 实际值为 (DPI_AWARENESS_CONTEXT)-1
• DPI_AWARENESS_CONTEXT_SYSTEM_AWARE 为 (DPI_AWARENESS_CONTEXT)-2
• DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE 为 (DPI_AWARENESS_CONTEXT)-3
• DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 为 (DPI_AWARENESS_CONTEXT)-4

错误的数值会直接导致API调用失败，返回false。

2. 调用时机过晚 #

SetProcessDpiAwarenessContext必须在创建任何窗口、GDI对象或UI相关资源之前调用。如果初始化日志过程中已经创建了控制台窗口、日志窗口或者其他UI元素，操作系统会锁定当前进程的DPI感知状态，后续调用会被拒绝。

3. 应用程序Manifest已声明DPI感知 #

如果你的程序嵌入了包含DPI感知声明的manifest文件（比如<dpiAware>true</dpiAware>或<dpiAwareness>PerMonitorV2</dpiAwareness>），操作系统会优先使用manifest中的设置，此时调用API修改状态会失败。

4. 缺少错误码排查 #

调用API返回false时，应通过Marshal.GetLastWin32Error()获取具体Windows错误码，比如：

• ERROR_ACCESS_DENIED(5)：说明DPI感知状态已被锁定（调用时机太晚或manifest已设置）
• ERROR_INVALID_PARAMETER(87)：说明传入的参数错误（比如枚举值不对）

using System.Runtime.InteropServices;

internal static class NativeMethods
{
    [DllImport("user32.dll", SetLastError = true)]
    internal static extern bool SetProcessDpiAwarenessContext(IntPtr dpiFlag);

    [DllImport("SHCore.dll", SetLastError = true)]
    internal static extern bool SetProcessDpiAwareness(PROCESS_DPI_AWARENESS awareness);

    // 正确的DPI感知上下文常量
    internal static readonly IntPtr DPI_AWARENESS_CONTEXT_UNAWARE = (IntPtr)(-1);
    internal static readonly IntPtr DPI_AWARENESS_CONTEXT_SYSTEM_AWARE = (IntPtr)(-2);
    internal static readonly IntPtr DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = (IntPtr)(-3);
    internal static readonly IntPtr DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 = (IntPtr)(-4);
}

public enum PROCESS_DPI_AWARENESS
{
    Process_DPI_Unaware = 0,
    Process_System_DPI_Aware = 1,
    Process_Per_Monitor_DPI_Aware = 2
}

public static void SetDpiAwareness()
{
    if (Environment.OSVersion.Version >= new Version(6, 3, 0))
    {
        if (Environment.OSVersion.Version >= new Version(10, 0, 15063))
        {
            bool success = NativeMethods.SetProcessDpiAwarenessContext(NativeMethods.DPI_AWARENESS_CONTEXT_UNAWARE);
            if (!success)
            {
                int errorCode = Marshal.GetLastWin32Error();
                // 记录错误码用于排查
            }
        }
        else
        {
            bool success = NativeMethods.SetProcessDpiAwareness(PROCESS_DPI_AWARENESS.Process_DPI_Unaware);
            if (!success)
            {
                int errorCode = Marshal.GetLastWin32Error();
            }
        }
    }
}

额外注意事项 #

• 确保SetDpiAwareness是程序启动后第一个执行的方法，早于任何UI初始化、日志窗口创建等操作。
• 检查程序的manifest文件，移除任何与DPI感知相关的声明，避免和API调用冲突。

内容的提问来源于stack exchange，提问作者Sjoerd222888