> ## 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.

# GameInputKeyboardInfo

> GameInputKeyboardInfo

# GameInputKeyboardInfo

描述鍵盤的屬性。

<a id="syntaxSection" />

## 語法

```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;
};
```

<a id="membersSection" />

### 成員

*kind*<br />
類型：[GameInputKeyboardKind](/zh-TW/reference/input/gameinput/enums/gameinputkeyboardkind)

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

*layout*<br />
類型：uint32\_t

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

*keyCount*<br />
類型：uint32\_t

鍵盤上的按鍵數目。

*functionKeyCount*<br />
類型：uint32\_t

鍵盤上的功能鍵數目。

*maxSimultaneousKeys*<br />
類型：uint32\_t

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

*platformType*<br />
類型：uint32\_t

鍵盤平台類型。

*platformSubtype*<br />
類型：uint32\_t

鍵盤平台子類型。

<a id="remarksSection" />

## 備註

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

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

<a id="requirementsSection" />

## 需求

**標頭：** GameInput.h

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

<a id="seealsoSection" />

## 另請參閱

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **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

- [GameInputKeyboardInfo](/reference/input/gameinput/structs/gameinputkeyboardinfo.md)
- [GameInputKeyboardKind](/reference/input/gameinput/enums/gameinputkeyboardkind.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [GameInputDeviceInfo](/reference/input/gameinput/structs/gameinputdeviceinfo.md)