【WCE】显示器电源管理 (Standard Shell)

在使用 Standard Shell 的情况下，出于节约用电和保护显示器的目的，我们需要在 User Idle 时进入显示器节电模式 (ScreenOff)，在 User Active 时退出显示器节电模式 (ScreenOn)。

该项功能要依靠 Power Manager 和 GWES 来实现，具体为：

• Power Manager 维护显示器电源状态，通过设备驱动控制显示器进入/退出节电模式。
• GWES 监视用户输入事件 (User Active) 并通知 Power Manager。

由于不少 BSP 未提供任何设备驱动来管理显示器，故我们需自行实现显示器电源管理功能。

在 $(_WINCEROOT)/PUBLIC/COMMON/OAK/FILES/common.reg 中存在：

[HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/Power]
    "DisableGwesPowerOff"=dword:0
    "ScreenPowerOff"=DWORD:300

根据 "DisableGwesPowerOff" 的值，存在两种实现方式：

• 当 "DisableGwesPowerOff"=dword:0，GWES 会发送 WM_POWERBROADCAST 消息给任务栏，具体可在 $(_WINCEROOT)/PUBLIC/SHELL/OAK/HPC/EXPLORER/TASKBAR/taskbar.cpp 中找到如下代码段：  

        case WM_POWERBROADCAST:
        {
            const WCHAR g_MessengerWindowClass[] = L"MSGSBlObj";
            HWND hwndMessenger;

            hwndMessenger = FindWindow(g_MessengerWindowClass, NULL);
            if (hwndMessenger)
            {
                // Notify Messenger of idle state
                PostMessage(
                                FindWindow(g_MessengerWindowClass, NULL),
                                msg,
                                wParam,
                                lParam
);
            }
        }
            // Place holder for real screen saver implementation
            switch(wParam)
            {
                case PBT_APMUSERIDLE:
                    // ScreenSaver start
                    RETAILMSG(TRUE, (L"Screen Saver Started. "));
                    break;

                // Screen saver app should be looking for this message
                case PBT_APMUSERACTIVE:
                    // ScreenSaver end
                    RETAILMSG(TRUE, (L"Screen Saver Ended. "));
                    break;
            }

            break;

 该段代码在 User Idle 时，调试输出“屏保已启动”；在 User Active 时，调试输出“屏保已结束”。考虑到多数 BSP 支持 GETPOWERMANAGEMENT / SETPOWERMANAGEMENT escape function，调用 ExtEscape 函数就可进入/退出节电显示器模式，修改后的代码如下： 

                case PBT_APMUSERIDLE:
                    // ScreenOff
                    SetScreenPower(FALSE);
                    break;

                case PBT_APMUSERACTIVE:
                    // ScreenOn
                    SetScreenPower(TRUE);
                    break;

其中，函数 SetScreenPower 的实现代码如下：

DWORD SetScreenPower(BOOL bScreenOn)
{
    HDC hDC(GetDC(NULL));
    if (!hDC) return GetLastError();

    _ATLTRY
    {
        DWORD dwQuery(GETPOWERMANAGEMENT);
        if (ExtEscape(hDC, QUERYESCSUPPORT, sizeof(DWORD), (LPCSTR)&dwQuery, 0, NULL) <= 0)
            AtlThrowLastWin32();

        VIDEO_POWER_MANAGEMENT power;
        power.Length = sizeof(power);
        if (ExtEscape(hDC, GETPOWERMANAGEMENT, 0, 0, sizeof(power), (LPSTR)&power) != sizeof(power))
            AtlThrowLastWin32();

        power.PowerState = bScreenOn ? VideoPowerOn : VideoPowerOff;
        if (ExtEscape(hDC, SETPOWERMANAGEMENT, sizeof(power), (LPSTR)&power, 0, NULL) <= 0)
            AtlThrowLastWin32();
    }
    _ATLCATCH(e)
    {
        ATLVERIFY(ReleaseDC(NULL, hDC));
        return HRESULT_CODE((HRESULT)e);
    }

    ATLVERIFY(ReleaseDC(NULL, hDC);
    return NO_ERROR;
}

• 当 "DisableGwesPowerOff"=dword:1，这时 GWES 不会发送 WM_POWERBROADCAST 消息给任务栏了。那么我们需要通过调用 RequestPowerNotifications 函数要求 Power Manager 将电源通告写入指定的消息队列。

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nCmdShow)
{
    // 消息队列参数
    MSGQUEUEOPTIONS qo;
    qo.dwSize = sizeof(MSGQUEUEOPTIONS);
    qo.dwFlags = MSGQUEUE_NOPRECOMMIT;
    qo.dwMaxMessages = 0;
    qo.cbMaxMessage = 256;
    qo.bReadAccess = TRUE;

    // 创建消息队列
    CSafeHandle<HANDLE, CloseMsgQueue> hPowerNMsgQ(CreateMsgQueue(NULL, &qo));

    // 请求电源通告
    CSafeHandle<HANDLE, (BOOL(__stdcall*)(HANDLE))StopPowerNotifications> hNotify(RequestPowerNotifications(hPowerNMsgQ, PBT_TRANSITION));  
 
    while (TRUE)
    {
        // 判断消息队列是否有数据写入
        if (WaitForSingleObject(hPowerNMsgQ, INFINITE) == WAIT_FAILED)
            return GetLastError();

        // 从消息队列读取数据
        BYTE buffer[256];
        DWORD cRead, dwFlags;   
        if (!ReadMsgQueue(hPowerNMsgQ, buffer, sizeof(buffer), &cRead, INFINITE, &dwFlags))
            return GetLastError();

        // 根据 Power Manager 维护的显示器电源状态，进入/退出节电模式
        PPOWER_BROADCAST pPowerBroadcast((PPOWER_BROADCAST)buffer);
        if (!_tcsicmp(pPowerBroadcast->SystemPowerState, TEXT("On")))
            SetScreenPower(TRUE);
        else if (!_tcsicmp(pPowerBroadcast->SystemPowerState, TEXT("SystemIdle")))
            SetScreenPower(FALSE);
    }

    return NO_ERROR;
}