> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInput 工作队列

> GameInput 工作队列

<a id="introductionSection" />

`GameInput` API 有时需要处理内部异步事件，例如输入设备的连接或断开。这些事件出现频率较低。但是，应用程序也可以注册可能需要更频繁调度的回调。默认情况下，`GameInput` 会创建一个以略高优先级 (`THREAD_PRIORITY_ABOVE_NORMAL`) 运行的工作线程来处理这些事件。

如果应用程序希望更精细地控制此工作何时执行以及在哪个线程/处理器上执行，可通过 [IGameInputDispatcher](/reference/input/gameinput/interfaces/IGameInputDispatcher/igameinputdispatcher) 接口手动控制这些事件的处理。可通过在 [IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput) 接口上调用 [CreateDispatcher](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher) 方法来获取该接口。该接口提供两个方法，可用于手动调度 `GameInput` 内部工作队列中的工作。使用 [Dispatch](/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_dispatch) 方法调度 `GameInput` 工作队列中的挂起工作（若有）。应用程序可以周期性地调用此方法，或者等待调度器的 [OpenWaitHandle](/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_openwaithandle) 方法返回的句柄，以检测是否有工作被排入队列并需要调度。

只要应用程序仍持有调度器接口的引用，就由它掌控工作的调度。一旦对调度器接口的所有引用都被释放，`GameInput` 会重新使用内部工作线程来处理这些事件。

<a id="seeAlsoSection" />

## 参考 API 文档

* [GameInput（API 目录）](/reference/input/gameinput/gameinput_members)

## 另请参阅

[GameInput 基础](/build/core-features/common/input/overviews/input-fundamentals)

[GameInput 高级主题](/build/core-features/common/input/advanced/input-advanced-topics)

[输入 API 参考](/reference/input/gc-reference-input-toc)


## Related topics

- [GameInput 回调](/zh-CN/build/core-features/common/input/advanced/input-callbacks.md)
- [GameInput 高级主题：力反馈与回调](/zh-CN/build/core-features/common/input/advanced/index.md)
- [GameInput 高级主题](/zh-CN/build/core-features/common/input/advanced/input-advanced-topics.md)
- [IGameInputDispatcher::Dispatch](/zh-CN/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_dispatch.md)
- [GameInput 概述](/zh-CN/build/core-features/common/input/overviews/input-overview.md)