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 n’est pas possible de déterminer le type d’appareil utilisé.

Remarques

Cette requête retourne le mode de la console, et non 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’elle est interrogée par un titre.

Un titre Microsoft Game Development Kit (GDK) généré pour la famille XBOX One ne retournera pas de code d’appareil des consoles XBOX Series, sauf si le paramètre XboxCompatibility du fichier MicrosoftGame.config est défini sur Scarlett. Il retournera à la place un code de la famille XBOX One en fonction de l’appareil actuel.

Appareil / mode réel	Généré pour la famille XBOX One	Généré pour les consoles XBOX Series
Kit de développement XBOX Series X	XboxOneXDevkit	XboxScarlettDevkit
XBOX Series X Mode de profilage Anaconda	XboxOneX	XboxScarlettAnaconda
XBOX Series S Mode de profilage Lockhart Kit 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 un kit 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