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

# GetDeviceStatus

> 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](/reference/input/gameinput/enums/gameinputdevicestatus)

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

## Remarks

The returned [GameInputDeviceStatus](/reference/input/gameinput/enums/gameinputdevicestatus) 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](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) method to react to specific changes in a device's state.

## Requirements

**Header:** GameInput.h

[Overview of GameInput](/build/core-features/common/input/overviews/input-overview)\
[GameInputDeviceStatus](/reference/input/gameinput/enums/gameinputdevicestatus)\
[RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Version History

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


## Related topics

- [GameInputDeviceStatus](/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [XAppBroadcastGetStatus](/reference/system/xappcapture/functions/xappbroadcastgetstatus.md)
- [PFAccountManagementClientLinkIOSDeviceIDAsync](/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientlinkiosdeviceidasync.md)
- [PFAccountManagementClientUnlinkIOSDeviceIDAsync](/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinkiosdeviceidasync.md)