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

# XSystemGetDeviceType

> XSystemGetDeviceType

# XSystemGetDeviceType

Retorna um valor de [XSystemDeviceType](/pt-BR/reference/system/xsystem/enums/xsystemdevicetype) correspondente ao dispositivo em uso no momento.

## Sintaxe

```cpp theme={null}
XSystemDeviceType XSystemGetDeviceType(  
)  
```

### Parâmetros

Nenhum.

### Valor retornado

Tipo: [XSystemDeviceType](/pt-BR/reference/system/xsystem/enums/xsystemdevicetype)

Valor da enumeração [XSystemDeviceType](/pt-BR/reference/system/xsystem/enums/xsystemdevicetype) correspondente ao dispositivo em uso no momento.

<Note>
  Esta função não tem um estado de erro explícito, mas retornará um valor de **XSystemDeviceType::Unknown** se não for possível determinar o tipo de dispositivo em uso.
</Note>

## Comentários

Esta consulta retornará o modo do console, e não o tipo real de hardware, o que significa que é possível que um console de desenvolvedor se passe por um tipo de dispositivo diferente quando consultado por um título.

<Note>
  Um título do Microsoft Game Development Kit (GDK) compilado para a família XBOX One não retornará um
  código de dispositivo dos consoles XBOX Series, a menos que a configuração XboxCompatibility no arquivo [MicrosoftGame.config](/pt-BR/reference/system/microsoftgameconfig/microsoftgameconfig-schema) esteja definida como Scarlett. Em vez disso, ele retornará um código da família XBOX One
  com base no dispositivo atual.

  | Dispositivo / modo real | Compilado para a família XBOX One | Compilado para consoles XBOX Series |
  | - | - | - |
  | Kit de desenvolvimento XBOX Series X | XboxOneXDevkit | XboxScarlettDevkit |
  | XBOX Series X<br />Modo de criação de perfil Anaconda | XboxOneX | XboxScarlettAnaconda |
  | XBOX Series S<br />Modo de criação de perfil Lockhart<br />Kit de teste XBOX Series S | XboxOneS | XboxScarlettLockhart |

  Para obter mais informações sobre o uso da família de dispositivos de destino, consulte
  [Visão geral do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview).
</Note>

É possível executar esta consulta antes de chamar [XGameRuntimeInitialize](/pt-BR/reference/system/xgameruntimeinit/functions/xgameruntimeinitialize) para permitir seu uso durante a inicialização antecipada do título.

Este exemplo obtém o tipo do dispositivo em uso no momento. Se estiver em execução em um kit de desenvolvimento, ele executará um código personalizado para habilitar recursos de desenvolvedor no jogo.

```cpp theme={null}
const XSystemDeviceType deviceType = XSystemGetDeviceType(); 
const bool deviceIsDevkit = 
    deviceType == XSystemDeviceType::XboxOneXDevkit || 
    deviceType == XSystemDeviceType::XboxScarlettDevkit; 
 
if (deviceIsDevkit) 
{ 
    EnableGameSpecificDevkitFeatures(); 
}
```

## Requisitos

**Cabeçalho:** XSystem.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XSystemDeviceType](/pt-BR/reference/system/xsystem/enums/xsystemdevicetype)\
[XSystem](/pt-BR/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemDeviceType](/pt-BR/reference/system/xsystem/enums/xsystemdevicetype.md)
- [XSystem](/pt-BR/reference/system/xsystem/xsystem_members.md)
- [Intelligent Delivery: especificadores de dispositivo](/pt-BR/build/core-features/common/packaging/intelligentdelivery-device.md)
- [Convites multiplayer entre versões de título do XDK e do GDK](/pt-BR/services/xbox-services/multiplayer/invites/concepts/live-multiplayer-xdkinvites.md)
- [XSystemGetAppSpecificDeviceId](/pt-BR/reference/system/xsystem/functions/xsystemgetappspecificdeviceid.md)