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

# GameInputKeyboardInfo

> GameInputKeyboardInfo

# GameInputKeyboardInfo

描述鍵盤的屬性。

## 語法

```cpp theme={null}
struct GameInputKeyboardInfo
{
    GameInputKeyboardKind kind;
    uint32_t              layout;
    uint32_t              keyCount;
    uint32_t              functionKeyCount;
    uint32_t              maxSimultaneousKeys;
    uint32_t              platformType;
    uint32_t              platformSubtype;
};
```

### 成員

*kind*\

類型：[GameInputKeyboardKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputkeyboardkind.md)

依鍵盤類型區分的鍵盤配置。

*layout*\

類型：uint32\_t

依國家/地區和語言區分的鍵盤配置。此參數包含的鍵盤配置識別碼值與 [GetKeyboardLayoutName](https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-getkeyboardlayoutnamea) 函式所提供的值相同，但以 32 位元整數而非字串表示。

*keyCount*\

類型：uint32\_t

鍵盤上的按鍵數目。

*functionKeyCount*\

類型：uint32\_t

鍵盤上的功能鍵數目。

*maxSimultaneousKeys*\

類型：uint32\_t

可登錄的同時按鍵輸入數目上限。

*platformType*\

類型：uint32\_t

鍵盤平台類型。

*platformSubtype*\

類型：uint32\_t

鍵盤平台子類型。

## 備註

此結構用於 [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md) 結構中。`GameInputDeviceInfo` 由 [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md) 方法使用。

如需詳細資訊，請參閱 [GameInput 裝置](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-devices.md)。

## 需求

**標頭：** GameInput.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | **已移除** `nativeLanguage` (GameInputString const\*)。 |
| **v0** | 推出。 |

## 附錄：先前版本

### v0

```cpp theme={null}
struct GameInputKeyboardInfo
{
    GameInputKeyboardKind  kind;
    uint32_t               layout;
    uint32_t               keyCount;
    uint32_t               functionKeyCount;
    uint32_t               maxSimultaneousKeys;
    uint32_t               platformType;
    uint32_t               platformSubtype;
    GameInputString const* nativeLanguage;
};
```


## Related topics

- [GameInputKeyboardKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputkeyboardkind.md)
- [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputKeyboardLayoutCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)