Skip to main content

XGameStreamingGetTouchBundleVersion

指定されたデバイスで現在使用されているタッチ アダプテーション バンドルのバージョンを取得します。

Syntax

Parameters

client   _In_
型: XGameStreamingClientId
照会するストリーミング クライアント。 version   _Out_opt_
型: XVersion*
指定されたクライアントで現在使用されているバンドルのバージョン番号。バンドルにバージョン番号が指定されていない場合、0.0.0.0 が返されます。 versionNameSize   _In_
型: size_t
返される versionName の最大サイズ (バイト単位)。指定するサイズは、XGameStreamingGetTouchBundleVersionNameSize を呼び出すことで取得できます。 versionName   _Out_writes_opt_z_
型: char*
指定されたクライアントで現在使用されているバンドルのバージョン名。バンドルにバージョン名が指定されていない場合、null が返されます。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

想定されるエラー

エラー コードの一覧については、Error Codes を参照してください。

Remarks

ゲーム ストリーミング中にプレイヤーに提示されるタッチ レイアウトは、タッチ アダプテーション バンドルの一部として Microsoft にアップロードされた事前定義済みのレイアウトを使用します。XGameStreamingGetTouchBundleVersion を使用すると、特定のクライアントで使用されているタッチ コントロールのセットに基づいて、ゲームが実行時に判断を行えます。これが利用されるいくつかの例:
  • プレイヤーがタッチを使用しており、要素がタッチ オーバーレイ コントロールを介して利用可能な場合、その要素を HUD から取り除く。
  • 表示されるタッチ レイアウトに基づいて、ゲーム内に表示するグラフィカルなヒントを決定する。
version は、サービスにアップロードされるバージョンごとに一意です。すべての更新には新しいバージョン番号が必要です。 versionName は、特定のバージョン番号に固定するのではなく、セマンティック バージョン (たとえば、これは DLC2 をサポートする一連のレイアウトです) を提供するために使用できます。たとえば、バージョン番号がビルド システムによって自動的に割り当てられる場合、実行時に表示されるタッチ アダプテーション バンドルの正確なバージョン番号をゲーム コード側で把握することが難しい場合があります。バンドルの正確なバージョンを知らなくてもコードでその存在を検出できるようにするため、バージョン番号による比較ではなくバージョン名を使用することを選択できます。

Example

Requirements

ヘッダー: XGameStreaming.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

See also

XGameStreaming
XGameStreamingGetTouchBundleVersionNameSize
最終更新日 2026年8月24日