语法
参数
device _In_opt_类型:IGameInputDevice* 可选,将注册的回调限定为由特定设备触发。 buttonFilter _In_
类型:GameInputSystemButtons 要接收回调的按钮集合,以逻辑 OR 组合。 context _In_opt_
类型:void* 为回调函数提供相关信息的对象。通常为调用对象。 callbackFunc _In_
类型:GameInputSystemButtonCallback 由标题定义、在按下或释放系统按钮时调用的回调函数。 callbackToken _Out_opt_
类型:GameInputCallbackToken* 标识已注册回调函数的令牌。如果需要取消或注销回调函数,可使用此令牌来标识已注册的函数。
返回值
类型:HRESULT 函数结果。备注
此方法注册一个在按下或释放 Guide 或 System 按钮时调用的回调函数。是否分发回调取决于你的进程和其他进程中通过 IGameInput::SetFocusPolicy 设置的 GameInputFocusPolicy。有关详细信息,请参阅 GameInputFocusPolicy。在 XBOX 上,系统外壳始终会使用 Guide 按钮,因此这些回调在 XBOX 上永远不会被分发。 在 PC 上,当 GameInput 运行时随应用程序旁加载而不是安装在系统上时,此方法将失败并返回GAMEINPUT_E_FEATURE_REQUIRES_INSTALL (0x838AD02B)。有关详细信息,请参阅 GameInput 旁加载。
若要停止接收回调,请参阅 IGameInput::UnregisterCallback 和 IGameInput::StopCallback 方法。
此方法已添加到 Windows SDK 10.0.26031 预览版的 GameInput.h 中,将添加到 GDK 的未来版本。
以下代码示例演示如何侦听 Guide 按钮的按下事件。
要求
头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机另请参阅
已弃用的 GameInput API 成员IGameInputReading::GetSystemButtonState
GameInput 高级主题
GameInput 概述
IGameInput
