通过

XSystemGetDeviceType

  • 项目

返回与当前使用的设备对应的 XSystemDeviceType 值。

语法

XSystemDeviceType XSystemGetDeviceType(  
)

参数

无。

返回值

类型：XSystemDeviceType

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

注意

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

备注

此查询将返回主机模式（而不是实际硬件类型），这意味着在某一游戏进行轮询时，开发者主机有可能冒充不同的设备类型。

注意

为 Xbox One 系列构建的 Microsoft 游戏开发工具包 （GDK） 游戏不会在 Xbox 系列主机中返回设备代码，除非 MicrosoftGame.config 文件中的 XboxCompatibility 设置设置为 Scarlett。 相反，它将基于当前设备从 Xbox One 系列中返回一个代码。

实际设备/模式 专为 Xbox One 系列构造 专为Xbox Series 主机构造
Xbox Series X 开发工具包 XboxOneXDevkit XboxScarlettDevkit
Xbox Series X
Anaconda 分析模式		 XboxOneX XboxScarlettAnaconda
Xbox Series S
Lockhart 分析模式
Xbox Series S 测试工具包		 XboxOneS XboxScarlettLockhart

有关目标设备家族使用情况的详细信息，请参阅 MicrosoftGame概述 "。

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

本例获取当前正在使用的设备的类型。 如果本示例正在 devkit 上运行，它将运行自定义代码，以便在游戏内启用开发者功能。

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

要求

头文件：XSystem.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XSystemDeviceType
XSystem