> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSystemGetDeviceType

> XSystemGetDeviceType

# XSystemGetDeviceType

返回与当前正在使用的设备相对应的 [XSystemDeviceType](/zh-CN/reference/system/xsystem/enums/xsystemdevicetype) 值。

## 语法

```cpp theme={null}
XSystemDeviceType XSystemGetDeviceType(  
)  
```

### 参数

无。

### 返回值

类型：[XSystemDeviceType](/zh-CN/reference/system/xsystem/enums/xsystemdevicetype)

与当前正在使用的设备相对应的 [XSystemDeviceType](/zh-CN/reference/system/xsystem/enums/xsystemdevicetype) 枚举值。

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

## 备注

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

> [!NOTE]
>
> 为 XBOX One 系列构建的 Microsoft Game Development Kit (GDK) 游戏在 XBOX Series 主机上不会返回设备代码，除非 [MicrosoftGame.config](/zh-CN/reference/system/microsoftgameconfig/microsoftgameconfig-schema) 文件中的 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 概述](/zh-CN/build/core-features/common/game-config/MicrosoftGameConfig-Overview)。

可以在调用 [XGameRuntimeInitialize](/zh-CN/reference/system/xgameruntimeinit/functions/xgameruntimeinitialize) 之前执行此查询，以便在游戏早期初始化期间使用它。

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

```cpp theme={null}
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](/zh-CN/reference/system/xsystem/enums/xsystemdevicetype)\
[XSystem](/zh-CN/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemDeviceType](/zh-CN/reference/system/xsystem/enums/xsystemdevicetype.md)
- [XSystem（API 内容）](/zh-CN/reference/system/xsystem/xsystem_members.md)
- [Intelligent Delivery：设备修饰符](/zh-CN/build/core-features/common/packaging/intelligentdelivery-device.md)
- [跨 Xbox One 软件开发工具包/GDK 游戏版本的邀请](/zh-CN/services/xbox-services/multiplayer/invites/concepts/live-multiplayer-xdkinvites.md)
- [XSystemGetAppSpecificDeviceId](/zh-CN/reference/system/xsystem/functions/xsystemgetappspecificdeviceid.md)