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

> GetDeviceStatus

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/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/enums/gameinputdevicestatus.md).

## Remarks

The returned [GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/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

[Overview of GameInput](https://docs.xbox.com/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/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 |
| - | - |
| **v0** | Introduced. |


## Related topics

- [GameInputDeviceStatus](https://docs.xbox.com/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [IGameInputDevice (Interface contents)](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [XAppBroadcastGetStatus](https://docs.xbox.com/reference/system/xappcapture/functions/xappbroadcastgetstatus.md)
- [Get Play Fab IDs From Nintendo Switch Device Ids](https://docs.xbox.com/api-reference/account-management/get-play-fab-ids-from-nintendo-switch-device-ids.md)
- [PFAccountManagementClientUnlinkIOSDeviceIDAsync](https://docs.xbox.com/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinkiosdeviceidasync.md)