Skip to main content

XGameStreamingGetGamepadPhysicality

特定のゲームパッドの読み取りから入力の物理性マッピングを取得します。

Syntax

Parameters

gamepadReading   _In_
型: IGameInputReading*
照会するゲームパッドの読み取り。 gamepadPhysicality   _Out_
型: XGameStreamingGamepadPhysicality*
入力読み取りの物理性。

Return value

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

Remarks

ゲームは、入力が物理的に接続されたコントローラーからのものか、それとも仮想コントローラー入力に変換されたタッチ レイアウトからのものかによって、コントローラー入力を区別する必要がある場合があります。 シナリオ例 ゲームには A ボタンに関連付けられた ジャンプ アクションがあります。ゲームは ジャンプ アイコンが仮想コントローラーの A ボタン押下として構成されたタッチ レイアウトを提供しています。また、ゲームはプレイヤーが物理コントローラーを再マッピングし、A をジャンプに関連付けないようにする機能も提供します。 ゲームでは、ゲーム内の要素との操作について視覚的なヒントを提示できます (例: A を押して ジャンプ)。プレイヤーがタッチ レイアウトを使用している場合、視覚的なヒントはタッチ レイアウトのボタンのアイコンを表示する必要があります。

Example

次のコード例では、ゲームは既定でコントローラーの A ボタンに ジャンプ アクションを紐付けています。この設定はプレイヤーによってカスタマイズ可能ですが、画面上のタッチ レイアウトは固定されているため、タッチ レイアウトからの A ボタン押下は常に ジャンプ として扱う必要があり、物理コントローラーからの A は、プレイヤーがコントローラー マッピングのカスタマイズで設定した内容として扱う必要があります。

Requirements

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

See also

XGameStreaming
XGameStreamingGamepadPhysicality
XGameStreaming Touch Adaptation
最終更新日 2026年8月24日