非UWP/非C++/WinRT的Win32 DLL中如何有效调用SetColor设置LED颜色？

问题根源 #

你的场景中，SetColor无效的核心原因是：

1. WinRT线程上下文不匹配：Windows::Devices::Lights API要求在**STA（单线程单元）**线程执行，而默认Win32线程多为MTA（多线程单元），导致命令无法传递到驱动。
2. WinRT环境初始化不完整：非UWP环境下必须手动初始化WinRT运行时，且需对应正确的线程模型。

分步解决方案 #

1. 初始化WinRT运行时 #

在DLL首次调用LampArray API前，完成WinRT初始化。注意区分STA/MTA模式：

#include <roapi.h>
#include <windows.devices.lights.h>
#include <windows.ui.h>

HRESULT InitWinRT()
{
    // 初始化STA模式的WinRT，允许重复调用（返回S_FALSE表示已初始化）
    HRESULT hr = RoInitialize(RO_INIT_SINGLETHREADED);
    return SUCCEEDED(hr) || hr == S_FALSE ? S_OK : hr;
}

void UninitWinRT()
{
    RoUninitialize();
}

2. 创建专用STA线程处理LampArray操作 #

由于LampArray依赖STA上下文，需创建独立STA线程执行颜色设置逻辑，避免与MTA线程冲突：

#include <thread>
#include <atomic>
#include <concurrency.h>

std::atomic<bool> g_isSTAThreadRunning = false;
std::thread g_staThread;
HWND g_msgWindow = nullptr;

LRESULT CALLBACK MsgWndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam)
{
    switch (msg)
    {
        case WM_USER + 1: // 处理颜色设置请求
        {
            auto lamp = reinterpret_cast<Windows::Devices::Lights::LampArray^>(wParam);
            auto color = *reinterpret_cast<Windows::UI::Color*>(lParam);
            
            lamp->SetColor(color);
            // 部分硬件需显式提交更改，同步等待完成
            concurrency::create_task(lamp->FlushAsync()).wait();
            
            delete reinterpret_cast<Windows::UI::Color*>(lParam);
            return 0;
        }
        case WM_DESTROY:
            PostQuitMessage(0);
            return 0;
        default:
            return DefWindowProc(hWnd, msg, wParam, lParam);
    }
}

void STAThreadProc()
{
    RoInitialize(RO_INIT_SINGLETHREADED);

    // 注册隐藏消息窗口类
    WNDCLASSEX wc = { sizeof(WNDCLASSEX), MsgWndProc, 0, 0, GetModuleHandle(nullptr),
                      nullptr, nullptr, nullptr, nullptr, L"LampArraySTAWindow" };
    RegisterClassEx(&wc);

    // 创建消息窗口（用于跨线程传递命令）
    g_msgWindow = CreateWindowEx(0, wc.lpszClassName, L"", 0, 0, 0, 0, 0, HWND_MESSAGE, nullptr, nullptr, nullptr);

    // 启动消息循环
    MSG msg;
    while (GetMessage(&msg, nullptr, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    // 清理资源
    DestroyWindow(g_msgWindow);
    UnregisterClass(wc.lpszClassName, wc.hInstance);
    RoUninitialize();
    g_isSTAThreadRunning = false;
}

void StartSTAThread()
{
    if (!g_isSTAThreadRunning)
    {
        g_isSTAThreadRunning = true;
        g_staThread = std::thread(STAThreadProc);
    }
}

void StopSTAThread()
{
    if (g_isSTAThreadRunning && g_msgWindow)
    {
        PostMessage(g_msgWindow, WM_DESTROY, 0, 0);
        if (g_staThread.joinable()) g_staThread.join();
    }
}

3. 导出供外部调用的SetColor API #

封装跨线程调用逻辑，对外暴露简洁的API：

extern "C" __declspec(dllexport) void SetLampArrayColor(Windows::Devices::Lights::LampArray^ lamp, Windows::UI::Color color)
{
    if (!g_isSTAThreadRunning) StartSTAThread();

    // 复制颜色对象到堆内存，避免线程间内存访问问题
    auto colorPtr = new Windows::UI::Color(color);
    PostMessage(g_msgWindow, WM_USER + 1, reinterpret_cast<WPARAM>(lamp), reinterpret_cast<LPARAM>(colorPtr));
}

4. DLL生命周期管理 #

在DllMain中处理线程和WinRT的初始化/清理：

BOOL APIENTRY DllMain(HMODULE hModule, DWORD ul_reason_for_call, LPVOID lpReserved)
{
    switch (ul_reason_for_call)
    {
        case DLL_PROCESS_ATTACH:
            InitWinRT();
            StartSTAThread();
            break;
        case DLL_PROCESS_DETACH:
            StopSTAThread();
            UninitWinRT();
            break;
        case DLL_THREAD_ATTACH:
        case DLL_THREAD_DETACH:
            break;
    }
    return TRUE;
}

关键注意事项 #

• 线程类型验证：可通过CoGetApartmentType检查线程单元类型，确保LampArray操作在STA线程执行。
• FlushAsync必要性：部分硬件设备不会自动提交SetColor的更改，必须显式调用FlushAsync同步或异步提交。
• 内存安全：跨线程传递数据时，需使用堆内存避免栈内存失效问题。

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