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

# IGameInputReading::GetSequenceNumber

> IGameInputReading::GetSequenceNumber

# IGameInputReading::GetSequenceNumber

检索输入读数的序列号。

## 语法

```cpp theme={null}
uint64_t GetSequenceNumber(  
         GameInputKind inputKind  
)  
```

### 参数

*inputKind*   \_In\_\
类型：[GameInputKind](/reference/input/gameinput/enums/gameinputkind)

要检索序列号的 [GameInputKind](/reference/input/gameinput/enums/gameinputkind)。\
虽然 [GameInputKind](/reference/input/gameinput/enums/gameinputkind) 通常是一个标志类型的枚举，但对于此参数只能使用一个值。

### 返回值

类型：uint64\_t

此函数尚未实现。
当前返回 0。

实现后，将返回输入读数的序列号。

## 备注

由 [GameInputKind](/reference/input/gameinput/enums/gameinputkind) 表示的每种输入类型都维护自己的序列号，只有在该输入类型的状态发生变化时才会更新。这一点非常重要，因为一个设备可能支持多种输入类型，因此其原始输入也可以有多种输入类型视图进行解释。来自同一设备的两次连续读数，可能在某一输入类型视图上有相同的序列号，而在原始数据的另一输入类型解释上具有不同的序列号。这表明游戏控制器只提供了某种特定类型的输入，因此只有那一个序列号被递增。
此函数可用于判断某种特定输入是否在两次读数之间发生了变化。当两次读数具有相同的时间戳时，序列号也可用于对读数进行排序和区分。

## 要求

**头文件：** GameInput.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[输入 API 概述](/build/core-features/common/input/overviews/input-overview)\
[IGameInputReading](/reference/input/gameinput/interfaces/igameinputreading/igameinputreading)\
[GameInputKind](/reference/input/gameinput/enums/gameinputkind)

## 版本历史

| 版本     | 更改    |
| ------ | ----- |
| **v3** | 重新引入。 |
| **v1** | 已移除。  |
| **v0** | 引入。   |


## Related topics

- [GameInput API 版本管理](/zh-CN/build/core-features/common/input/overviews/input-versioning.md)
- [IGameInputReading::GetInputKind](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md)
- [IGameInputReading::GetDevice](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getdevice.md)
- [IGameInputReading::GetTimestamp](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettimestamp.md)
- [IGameInputReading::GetGamepadState](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)