手柄键盘原理揭秘：XboxFullScreenExperienceTool的触摸注入与触摸键盘自动拉起

XboxFullScreenExperienceTool 是一款在 Windows 11 上一键启用 Xbox 全屏体验（FSE）的 GUI 工具，其中最"硬核"的功能是手柄键盘（Gamepad Keyboard）：在无触摸屏的 PC 上，通过模拟触摸输入并在后台悄悄拉起系统触摸键盘 TabTip.exe，让你用 Xbox 手柄就能完成文字输入，甚至可以在登录界面用手柄输入 PIN 码。本文从源码角度拆解它的触摸注入与键盘自动拉起机制。

一、为什么手柄键盘需要"欺骗"系统？

在掌机上，Xbox 的手柄键盘依赖系统识别出"这是一台带触摸屏的设备"。Windows 的屏幕键盘进程TabTip.exe虽然本身不挑硬件，但 Xbox 的手柄键盘入口、登录界面的 PIN 触摸盘等交互，都以系统具备触摸能力为前提。

普通 PC 没有触摸屏，Windows 自然认为不存在触摸设备。XboxFullScreenExperienceTool 的解决办法分两步：

1. 触摸注入（Touch Injection）：向系统注入虚拟触摸事件，让 Windows 把本机当成"触摸屏设备"；
2. 键盘自动拉起：在后台启动TabTip.exe并确保其处于就绪状态，但不让它弹满屏幕，需要时再由手柄召唤。

对应源码分别在 TouchManager.cpp 与 KeyboardManager.cpp，命令行入口定义在 PhysPanelCPP.cpp 的touchservice和startkeyboard两个子命令中。

二、原理一：触摸注入——让 Windows 以为自己是触摸屏

2.1 两个关键的 Windows API

触摸注入的核心在 TouchManager.cpp 中，动态加载User32.dll并调用两个非公开 API：

• InitializeTouchInjection：初始化一个可注入 10 个触摸点的会话；
• InjectTouchInput：向系统注入实际的触摸事件。

项目并不会真的"画"一个触摸点，而是构造一个TOUCH_FLAG_NONE的"探针"触摸（pointerId 为 0，位置 0,0），反复注入直到系统返回成功——一旦探针成功，说明触摸注入通道已经打通，系统即认为本机具备触摸屏。探针最多重试60 次、每次间隔 500ms，覆盖系统触摸子系统尚未就绪的情况。

2.2 主从（Master-Worker）架构：为什么需要 SYSTEM 权限？

这是整个设计最精巧的部分。触摸注入必须运行在每个用户会话、每个桌面里才有效（桌面包括登录界面的winsta0\winlogon和游戏所在的winsta0\default），而任务计划任务只能以 SYSTEM 身份（Session 0）启动。项目因此采用两级架构（见 RunService()）：

Master 通过CreateProcessAsUserW把自身以touchservice参数注入目标会话（LaunchAsSystemInSession），Worker 探针成功后进入消息循环常驻，只要 Master 存活就保持触摸通道；Master 消失时 Worker 自动退出。互斥量还保证了同一会话同一桌面只会有一个 Worker 运行。

简记：Session 0 负责"看门"，用户会话负责"碰屏"，互斥量负责"防重"。

三、原理二：触摸键盘自动拉起（startkeyboard）

触摸能力就绪后，还要把TabTip.exe准备好。KeyboardManager::StartTouchKeyboard()（KeyboardManager.cpp）的流程是典型的"启动 → 轮询 → 收起"：

1. 检测并启动：先用进程快照检查TabTip.exe是否在跑；若没有，从C:\Program Files (x86)\Microsoft Shared\ink\TabTip.exe启动，启动前等待explorer.exe就绪（最多 30 秒），避免桌面未准备好时启动失败。
2. 轮询可见性：通过 COM 接口IFrameworkInputPane的Location()查询输入面板矩形——宽高都大于 0 即说明键盘可见（IsTouchKeyboardVisible）。
3. 主动收起：一旦键盘弹出，立即连接ITipInvocationCOM 服务并调用Toggle()把它隐藏。

最终效果是：TabTip.exe 在后台静静待命，屏幕上不出现任何弹窗，但当你用手柄打开 Xbox 手柄键盘时，系统可以瞬间响应——包括登录界面的 PIN 输入。

失败时会抛出两种自定义异常（KeyboardManager.h）：TabTipNotFoundException（找不到 TabTip.exe）和TabTipActivationException（COM 服务无响应），调用方可以据此提示用户。

四、如何启用：一个复选框搞定

在工具主界面中勾选"Simulate touch input on startup to enable the gamepad keyboard (restart required)"（开机模拟触摸输入以启用手柄键盘，需重启）即可。界面效果见文首截图，该选项由 MainForm 的chkStartKeyboardOnLogon复选框承载。

勾选后，工具会在任务计划程序中创建名为XFSET-SimulateTouchService的系统级任务（CreateSimulateTouchTask），关键配置如下：

• 触发器：BootTrigger，开机即运行（早于用户登录，因此登录界面 PIN 也可用手柄输入）；
• 身份：S-1-5-18（LocalSystem）最高权限；
• 动作：执行PhysPanelCS.exe touchservice；
• 优先级：0（实时优先级），确保触摸模拟第一时间生效。

卸载或点击Disable & Restore时，该任务会被一并删除，系统恢复原状。

命令行手动验证

如果想自己验证这套机制，可以手动执行（PhysPanelCPP.cpp）：

PhysPanelCPP.exe touchservice # 以 SYSTEM 身份运行时会启动 Master 服务 PhysPanelCPP.exe startkeyboard # 拉起并收起触摸键盘

五、小结

XboxFullScreenExperienceTool 的手柄键盘功能，本质上是两个机制的巧妙组合：

• 🖐触摸注入：用InitializeTouchInjection+InjectTouchInput探针把无触摸屏的 PC"伪装"成触摸屏，并以 Session 0 Master + 用户会话 Worker 的双层架构保证覆盖登录与游戏桌面；
• ⌨️键盘自动拉起：后台启动TabTip.exe，轮询确认就绪后调用ITipInvocation::Toggle()将其收起，让手柄键盘随时待命而屏幕保持干净。

整个过程无需修改系统文件、无需驱动，靠的都是 Windows 公开/半公开的 API，这也是该项目"安全可逆"设计哲学的体现。更多使用说明可参考 README.md。

附：核心源码索引