XSystemGetDeviceType

Syntax

XSystemDeviceType XSystemGetDeviceType(  
)  

Parameters

なし。

Return value

現在使用中のデバイスに対応する XSystemDeviceType 列挙値。

この関数には明示的なエラー状態はありませんが、使用中のデバイスの種類を特定できない場合は XSystemDeviceType::Unknown の値を返します。

Remarks

このクエリは、実際のハードウェアの種類ではなく、本体モードを返します。これは、タイトルがポーリングしたときに開発者本体が別のデバイスタイプに見せかけることができるためです。

XBOX One ファミリ本体向けにビルドされた Microsoft Game Development Kit (GDK) タイトルは、MicrosoftGame.config ファイルの XboxCompatibility 設定が Scarlett に設定されていない限り、XBOX Series 本体内でデバイスコードを返しません。代わりに、現在のデバイスに基づいて 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

Syntax

Parameters

Return value

Remarks

Requirements

See also

​XSystemGetDeviceType

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

XSystemGetDeviceType

Syntax

Parameters

Return value

Remarks

Requirements

See also