> ## 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](/zh-TW/reference/input/gameinput/enums/gameinputkind)

要擷取序號的 [GameInputKind](/zh-TW/reference/input/gameinput/enums/gameinputkind)。\
雖然 [GameInputKind](/zh-TW/reference/input/gameinput/enums/gameinputkind) 通常是旗標類型的列舉，但此參數只能使用一個值。

### 傳回值

類型：uint64\_t

此函式尚未實作
目前傳回 0。

實作後，會傳回輸入讀數的序號。

## 備註

[GameInputKind](/zh-TW/reference/input/gameinput/enums/gameinputkind) 所代表的每種輸入類型都會維護自己的序號，只有在該輸入類型的狀態變更時才會更新。這點很重要，因為一個裝置可能支援多種輸入類型，因此也有多個可從其原始輸入解譯的輸入類型檢視。來自同一裝置的兩個連續讀數，在原始資料的某個輸入類型檢視上可能具有相同的序號，而在另一個輸入類型對原始資料的解譯上則具有不同的序號。這表示遊戲控制器提供了某種特定類型的輸入，因此只有該序號遞增。
此函式可用來判斷特定類型的輸入在讀數之間是否已變更。在兩個讀數具有相同時間戳記的情況下，序號也可用來排序及區分讀數。

## 需求

**標頭：** GameInput.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

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

## 版本歷程記錄

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


## Related topics

- [GameInput API 版本控制](/zh-TW/build/core-features/common/input/overviews/input-versioning.md)
- [IGameInputReading::GetInputKind](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md)
- [IGameInputReading::GetTimestamp](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettimestamp.md)
- [IGameInputReading::GetDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getdevice.md)
- [IGameInputReading::GetSensorsState](/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md)