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

# GameInputString

> GameInputString

# GameInputString

<Warning>**已弃用。** 此结构已在 GameInput v1 中移除，当前 API 中不再提供。</Warning>

表示用于 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`）。它在 v1 中被移除，当时那些字符串字段从 [GameInputDeviceInfo](/reference/input/gameinput/structs/gameinputdeviceinfo) 中删除。

## 版本历史

| 版本     | 变更   |
| ------ | ---- |
| **v1** | 已移除。 |
| **v0** | 已引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)