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

# GetSensorsState

> IGameInputReading::GetSensorsState

# IGameInputReading::GetSensorsState

擷取描述裝置上感應器狀態的輸入讀數檢視。

## 語法

```cpp theme={null}
bool GetSensorsState(
    GameInputSensorsState* state
);
```

### 參數

*state*   \_Out\_\
類型：[GameInputSensorsState\*](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputsensorsstate.md)

將輸入解譯為一組感應器的結果。

### 傳回值

類型：bool

成功解譯感應器輸入時傳回 true。嘗試讀取無法辨識為感應器輸入的輸入時傳回 false。

## 備註

呼叫 [IGameInputReading::GetInputKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md) 方法，以查看哪些 Get\*State 函式會針對某個 [IGameInputReading](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md) 傳回有效的解譯。每個 Get\*State 函式在 [IGameInputReading::GetInputKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md) 列舉中都有對應的項目。如果您在未設定對應 [IGameInputReading::GetInputKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md) 旗標的情況下呼叫 Get\*State 函式，該函式會傳回預設的靜止值，並傳回 false。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[輸入 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\

[IGameInputReading](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)\

[GameInputSensorsState](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputsensorsstate.md)\

[GameInputSensorsInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputsensorsinfo.md)\

[GameInputSensorsKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputsensorskind.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v2** | 推出。 |


## Related topics

- [GameInputSensorsState](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputsensorsstate.md)
- [IGameInputReading (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputSensorsKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputsensorskind.md)