Windows11下TSF自定义IME使用微软拼音时键盘事件阻塞问题求助

1. 会阻塞键盘事件传播的TSF内部状态 #

• 未释放的合成会话锁定：当TSF处于合成激活状态（如候选词选择阶段），若IME未正确处理合成的结束/暂停切换，TSF会持有输入事件锁定，阻止后续键盘事件投递到IME线程。
• 文档上下文焦点未同步：系统输入法（如微软拼音）切换输入模式时，TSF内部的文档上下文焦点可能未同步更新，导致事件被路由到错误上下文，而非你的IME线程隐藏窗口。
• TSF输入队列阻塞：若IME未及时响应TextStoreAPC的异步请求（如处理延迟），TSF会暂停向IME投递键盘事件，直到未处理的APC完成。
• 转换状态不一致：当IME向TSF发送转换状态变更但未与系统输入法状态同步时，可能触发TSF内部状态冲突，导致事件管道阻塞。

2. 文档焦点所有权的影响 #

• TSF的键盘事件路由完全依赖当前激活的文档上下文焦点：只有持有焦点的上下文对应的IME才能接收事件。微软拼音切换模式时可能抢占焦点所有权，导致你的IME线程隐藏窗口失去TSF焦点关联，事件无法投递。
• AssociateFocus关联有效性：若你的IME通过AssociateFocus绑定的上下文未在状态切换时重新确认，系统输入法修改焦点关联文档后，你的IME会被排除在事件路由外。调用AssociateFocus关联空文档相当于强制重置TSF焦点路由，让事件重新流向你的IME窗口。
• 跨线程焦点兼容性：TSF对跨线程焦点关联有严格校验，若隐藏窗口所在线程未正确维护TSF上下文激活状态，系统输入法切换时可能导致焦点所有权被系统收回，事件管道中断。

3. 防止事件管道阻塞的推荐模式 #

• 依赖TSF上下文路由，放弃手动焦点管理：停止使用::SetFocus手动设置窗口焦点，改用ITfDocumentMgr和ITfContext接口管理激活状态，让TSF自动处理事件路由，减少焦点冲突。
• 简化状态变更逻辑：参考讯飞IME的实现，尽量不向TSF/IMM发送转换状态变更，在IME内部维护输入模式状态，避免触发TSF内部状态冲突。
• 及时处理合成会话生命周期：在候选词选择阶段检测到Shift等模式切换键时，主动结束当前合成会话（通过ITfContextOwnerCompositionSink::OnCompositionTerminated或手动终止），释放TSF合成锁定，确保事件正常传递。
• 主动重置焦点关联：当检测到事件阻塞（如长时间未收到键盘事件），自动调用AssociateFocus关联空文档后重新绑定目标上下文，强制恢复事件流。
• 优化APC处理：确保TextStoreAPC的处理过程无阻塞，及时响应TSF异步请求，避免TSF因等待APC完成而暂停事件投递。

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