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

# GetDeviceStatus (Deprecated)

> Retrieves the current status of an input device (removed in v4).

> [!WARNING]
>
> **Deprecated.** This method was removed in GameInput v4 and is not available in the current API. Use [IGameInputDevice::IsConnected](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md) to check whether a device is connected, and handle [GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) values in the device callback to react to changes.

Retrieves the current status of an input device.

## Syntax

```cpp theme={null}
GameInputDeviceStatus GetDeviceStatus();
```

### Parameters

This method has no parameters.

### Return value

Type: [GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)

The value returned is the enumeration type `GameInputDeviceStatus`. The value returned may be a combination of the enumerated flag values from [GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md).

## Remarks

The returned [GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md) enumeration defines whether the device is connected, and the types of input and output that may be transmitted between the game and the device. If the `GetDeviceStatus` method is called when the device has been disconnected from the system, the `GameInputDeviceNoStatus` value is returned. You can use the `GameInputDeviceStatus` enumeration as a filter for the [RegisterDeviceCallback](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) method to react to specific changes in a device's state.

## Requirements

**Header:** GameInput.h

## See also

[Deprecated GameInput API members](https://docs.xbox.com/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice::IsConnected](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[Overview of GameInput](https://docs.xbox.com/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)\
[RegisterDeviceCallback](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[IGameInputDevice](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Version History

| Version | Changes |
| - | - |
| **v4** | Removed. |
| **v0** | Introduced. |


## Related topics

- [GetDeviceStatus](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GameInputDeviceStatus (Deprecated)](https://docs.xbox.com/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)
- [GetDeviceInfo (Deprecated)](https://docs.xbox.com/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md)
- [IGameInputDevice::GetRawDeviceFeature (Deprecated)](https://docs.xbox.com/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getrawdevicefeature.md)
- [IGameInputDevice::GetBatteryState (Deprecated)](https://docs.xbox.com/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)