XSystemGetDeviceType

语法

XSystemDeviceType XSystemGetDeviceType(  
)  

参数

无。

返回值

与当前正在使用的设备相对应的 XSystemDeviceType 枚举值。

此函数没有显式的错误状态，但如果无法确定正在使用的设备类型，将返回 XSystemDeviceType::Unknown 值。

备注

此查询将返回主机模式，而不是实际的硬件类型，这意味着当游戏进行轮询时，开发人员主机可能会伪装成不同的设备类型。

为 XBOX One 系列构建的 Microsoft Game Development Kit (GDK) 游戏在 XBOX Series 主机上不会返回设备代码，除非 MicrosoftGame.config 文件中的 XboxCompatibility 设置设置为 Scarlett。相反，它将根据当前设备返回 XBOX One 系列的代码。

实际设备/模式	为 XBOX One 系列构建	为 XBOX Series 主机构建
XBOX Series X Dev Kit	XboxOneXDevkit	XboxScarlettDevkit
XBOX Series X Anaconda 分析模式	XboxOneX	XboxScarlettAnaconda
XBOX Series S Lockhart 分析模式 XBOX Series S Test Kit	XboxOneS	XboxScarlettLockhart

有关目标设备系列使用情况的详细信息，请参阅 MicrosoftGame.config 概述。

可以在调用 XGameRuntimeInitialize 之前执行此查询，以便在游戏早期初始化期间使用它。

此示例获取当前正在使用的设备的类型。如果它在开发工具包上运行，则运行自定义代码以在游戏中启用开发人员功能。

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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XSystemGetDeviceType

语法

参数

返回值

备注

要求

另请参阅

​XSystemGetDeviceType

​语法

​参数

​返回值

​备注

​要求

​另请参阅

XSystemGetDeviceType

语法

参数

返回值

备注

要求

另请参阅