跳转到主要内容
检索设备的键盘属性,例如其键盘类型、布局和按键数量。

语法

参数

info   _Out_
类型:GameInputKeyboardInfo*
指向 GameInputKeyboardInfo 结构的指针,该结构接收设备的键盘属性。如果设备不支持键盘输入,则该结构的每个成员都设置为零。

返回值

类型:bool 如果设备支持键盘输入并且已填充 info,则为 true;否则为 false。

备注

GetKeyboardInfo 方法将设备的键盘属性复制到调用方提供的结构中。当 GetSupportedInput 返回的值包含 GameInputKindKeyboard 时,设备支持键盘输入。如果设备不支持键盘输入,GetKeyboardInfo 会将 info 零初始化并返回 false。 大多数键盘属性在设备的生存期内是固定的。例外的是 layout 成员,当活动键盘布局更改时(例如用户切换输入语言时),GameInput 会就地更新该成员。布局更改时,GameInput 会向通过 IGameInput::RegisterDeviceCallback 注册的设备回调引发 GameInputDeviceEventKeyboardLayoutUpdated GameInputDeviceEvent。在该回调中再次调用 GetKeyboardInfo 以读取新布局。 以下示例演示如何查询设备的键盘属性。
在 GameInput v3 及更早版本中,此信息可从 IGameInputDevice::GetDeviceInfo 返回的 GameInputDeviceInfo 结构的 keyboardInfo 成员中获取。

要求

头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice

版本历史

最后修改于 2026年11月6日