如何在正确线程中从MAUI代码后置调用WinRT，解决GraphicsCapturePicker异常

错误原因 #

MAUI的UI线程上下文和WinRT原生组件GraphicsCapturePicker要求的线程封送上下文不匹配：即便代码写在MAUI的按钮点击回调（默认跑在MAUI UI线程）中，该线程也不是WinRT组件要求的、绑定到原生WinUI窗口的STA线程，直接调用就会触发跨线程接口封送的COM异常。而纯UWP项目的默认UI线程本身就符合WinRT组件的上下文要求，所以相同代码可以正常运行。

修复方案 #

需要先拿到WinUI原生窗口的调度器，把GraphicsCapturePicker的初始化、调用逻辑都放到原生调度器的队列中执行，同时要正确关联窗口句柄、使用异步等待调用WinRT异步方法，修复后代码如下：

private async void OnScreenCaptureClicked(object sender, EventArgs e)
{
#if WINDOWS
    // 获取当前MAUI窗口对应的WinUI原生窗口实例
    var nativeWindow = Microsoft.Maui.Controls.Application.Current?.Windows.FirstOrDefault()?.Handler?.PlatformView as Microsoft.UI.Xaml.Window;
    if (nativeWindow == null) return;

    // 把捕获逻辑投递到原生窗口的调度队列中执行
    nativeWindow.DispatcherQueue.TryEnqueue(async () =>
    {
        var picker = new GraphicsCapturePicker();
        // 关联当前应用窗口句柄，避免选择器弹窗无法正常弹出
        var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(nativeWindow);
        WinRT.Interop.InitializeWithWindow.Initialize(picker, hwnd);
        
        // 异步等待选择结果，不要使用GetResults()同步阻塞
        GraphicsCaptureItem item = await picker.PickSingleItemAsync();
        // 后续对item的业务处理逻辑写在此处即可
    });
#endif
}

额外注意事项 #

• 必须在项目的Windows平台清单Package.appxmanifest中开启**图形捕获(Graphics Capture)**权限，否则调用会返回空结果或者无权限异常。
• 不要使用GetResults()同步调用WinRT异步方法，线程阻塞会加剧上下文冲突，也容易导致应用无响应。

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