> ## 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::GetSensorsState

> IGameInputReading::GetSensorsState

# IGameInputReading::GetSensorsState

Retrieve a view of the input reading that describes the state of sensors on the device.

## Syntax

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

### Parameters

*state*   \_Out\_\
Type: [GameInputSensorsState\*](/reference/input/gameinput/structs/gameinputsensorsstate)

Interpretation of the input as a set of sensors.

### Return value

Type: bool

Returns true on successful interpretation of sensor input. Returns false when attempting to read an input that is not recognized as sensor input.

## Remarks

Call the [IGameInputReading::GetInputKind](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind) method to see which Get\*State functions will return a valid interpretation for some [IGameInputReading](/reference/input/gameinput/interfaces/igameinputreading/igameinputreading). Each Get\*State function has a corresponding entry in the [IGameInputReading::GetInputKind](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind) enum. If you attempt to call a Get\*State function where the corresponding [IGameInputReading::GetInputKind](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind) flag is not set, the function will return with default at rest values as well as a false return value.

## Requirements

**Header:** GameInput.h

**Library:** gameinput.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

[Input API Overview](/build/core-features/common/input/overviews/input-overview)<br />
[IGameInputReading](/reference/input/gameinput/interfaces/igameinputreading/igameinputreading)<br />
[GameInputSensorsState](/reference/input/gameinput/structs/gameinputsensorsstate)<br />
[GameInputSensorsInfo](/reference/input/gameinput/structs/gameinputsensorsinfo)<br />
[GameInputSensorsKind](/reference/input/gameinput/enums/gameinputsensorskind)

## Version History

| Version | Changes     |
| ------- | ----------- |
| **v2**  | Introduced. |


## Related topics

- [GameInputSensorsState](/reference/input/gameinput/structs/gameinputsensorsstate.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [IGameInputReading::GetGamepadState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [IGameInputReading::GetKeyState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getkeystate.md)
- [IGameInputReading::GetMouseState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)