XSystemGetDeviceType

Sintaxe

XSystemDeviceType XSystemGetDeviceType(  
)  

Parâmetros

Nenhum.

Valor retornado

Valor da enumeração XSystemDeviceType correspondente ao dispositivo em uso no momento.

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.

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

É possível executar esta consulta antes de chamar 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.

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

Porting

Build Paths

XSystemGetDeviceType

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​XSystemGetDeviceType

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

XSystemGetDeviceType

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também