> ## 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 (Preterido)

> Recupera o status atual de um dispositivo de entrada (removido na v4).

> [!WARNING]
>
> **Preterido.** Este método foi removido no GameInput v4 e não está disponível na API atual. Use [IGameInputDevice::IsConnected](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md) para verificar se um dispositivo está conectado e trate os valores de [GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) no retorno de chamada de dispositivo para reagir a alterações.

Recupera o status atual de um dispositivo de entrada.

## Sintaxe

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

### Parâmetros

Este método não tem parâmetros.

### Valor retornado

Tipo: [GameInputDeviceStatus](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)

O valor retornado é do tipo de enumeração `GameInputDeviceStatus`. O valor retornado pode ser uma combinação dos valores de sinalizador enumerados de [GameInputDeviceStatus](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md).

## Comentários

A enumeração [GameInputDeviceStatus](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md) retornada define se o dispositivo está conectado e os tipos de entrada e saída que podem ser transmitidos entre o jogo e o dispositivo. Se o método `GetDeviceStatus` for chamado quando o dispositivo tiver sido desconectado do sistema, o valor `GameInputDeviceNoStatus` será retornado. Você pode usar a enumeração `GameInputDeviceStatus` como filtro para o método [RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) para reagir a alterações específicas no estado de um dispositivo.

## Requisitos

**Cabeçalho:** GameInput.h

## Confira também

[Membros preteridos da API GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice::IsConnected](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceStatus](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)\
[RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v4** | Removido. |
| **v0** | Introduzido. |


## Related topics

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