XSystemGetDeviceType

Syntaxe

XSystemDeviceType XSystemGetDeviceType(  
)  

Paramètres

Aucun.

Valeur de retour

Valeur d’énumération XSystemDeviceType correspondant à l’appareil actuellement utilisé.

Cette fonction n’a pas d’état d’erreur explicite, mais elle retourne la valeur XSystemDeviceType::Unknown s’il est impossible de déterminer le type d’appareil utilisé.

Remarques

Cette requête retourne le mode de la console, plutôt que le type de matériel réel, ce qui signifie qu’une console de développement peut se faire passer pour un autre type d’appareil lorsqu’un titre l’interroge.

Un titre Microsoft Game Development Kit (GDK) conçu pour la famille XBOX One ne retournera pas de code d’appareil des consoles XBOX Series, à moins que le paramètre XboxCompatibility du fichier MicrosoftGame.config soit défini sur Scarlett. Il retournera plutôt un code de la famille XBOX One en fonction de l’appareil actuel.

Appareil réel / Mode	Conçu pour la famille XBOX One	Conçu pour les consoles XBOX Series
Trousse de développement XBOX Series X	XboxOneXDevkit	XboxScarlettDevkit
XBOX Series X Mode de profilage Anaconda	XboxOneX	XboxScarlettAnaconda
XBOX Series S Mode de profilage Lockhart Trousse de test XBOX Series S	XboxOneS	XboxScarlettLockhart

Pour plus d’informations sur l’utilisation de la famille d’appareils cible, consultez Vue d’ensemble de MicrosoftGame.config.

Il est possible d’exécuter cette requête avant d’appeler XGameRuntimeInitialize afin de permettre son utilisation au début de l’initialisation du titre.

Cet exemple obtient le type de l’appareil actuellement utilisé. S’il s’exécute sur une trousse de développement, il exécute du code personnalisé pour activer des fonctionnalités de développement dans le jeu.

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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XSystemGetDeviceType

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi

​XSystemGetDeviceType

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Voir aussi

XSystemGetDeviceType

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi