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

# XSystemGetDeviceType

> XSystemGetDeviceType

# XSystemGetDeviceType

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

## Sintaxe

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

### Parâmetros

Nenhum.

### Valor retornado

Tipo: [XSystemDeviceType](https://docs.xbox.com/pt-BR/reference/system/xsystem/enums/xsystemdevicetype.md)

Valor da enumeração [XSystemDeviceType](https://docs.xbox.com/pt-BR/reference/system/xsystem/enums/xsystemdevicetype.md) 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.

## 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](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md) 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 Modo de criação de perfil Anaconda | XboxOneX | XboxScarlettAnaconda |
> | XBOX Series S Modo de criação de perfil Lockhart 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](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md).

É possível executar esta consulta antes de chamar [XGameRuntimeInitialize](https://docs.xbox.com/pt-BR/reference/system/xgameruntimeinit/functions/xgameruntimeinitialize.md) 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](https://docs.xbox.com/pt-BR/reference/system/xsystem/enums/xsystemdevicetype.md)\
[XSystem](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)


## Related topics

- [XSystemDeviceType](https://docs.xbox.com/pt-BR/reference/system/xsystem/enums/xsystemdevicetype.md)
- [XSystem (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)
- [Intelligent Delivery: especificadores de dispositivo](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/intelligentdelivery-device.md)
- [Convites entre versões de título do Xbox One Software Development Kit/GDK](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/concepts/live-multiplayer-xdkinvites.md)
- [XSystemGetAppSpecificDeviceId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetappspecificdeviceid.md)