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

# GameInputString (已淘汰)

> GameInputString

# GameInputString

> [!WARNING]
>
> **已淘汰。** 此結構已在 GameInput v1 中移除，目前的 API 中無法使用。

代表 GameInput 結構中用於裝置識別欄位的字串值。

## 語法

```cpp theme={null}
typedef struct GameInputString {
    uint32_t sizeInBytes;
    uint32_t codePointCount;
    const char* data;
} GameInputString;
```

## 成員

**sizeInBytes**\
類型：uint32\_t

字串資料的大小 (以位元組為單位)，不包括 null 結束字元。

**codePointCount**\
類型：uint32\_t

字串中的 Unicode 字碼指標數目。

**data**\
類型：const char\*

指向以 UTF-8 編碼之字串資料的指標。不一定以 null 結束。

## 備註

此類型用於 v0 `GameInputDeviceInfo` 結構中的字串欄位 (例如 `displayName`、`deviceFamily` 和 `hardwareVersion`)。當這些字串欄位從 [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md) 中移除時，此類型也在 v1 中一併移除。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)


## Related topics

- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [IGameInput::FindDeviceFromObject (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromPlatformHandle (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)
- [GameInputLocation (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputlocation.md)
- [GameInputMotionState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputmotionstate.md)