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

# GameInputControllerInfo (非推奨)

> コントローラーのプロパティを記述します (v4 で削除)。

> [!WARNING]
>
> **非推奨。** この構造体は GameInput v4 で削除され、現在の API では利用できません。代わりに [IGameInputDevice::GetControllerAxisCount](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md)、[GetControllerAxisLabels](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxislabels.md)、[GetControllerButtonCount](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttoncount.md)、[GetControllerButtonLabels](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttonlabels.md)、[GetControllerSwitchCount](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchcount.md)、[GetControllerSwitchInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchinfo.md) を使用してください。

コントローラーのプロパティを記述します。

## 構文

```cpp theme={null}
struct GameInputControllerInfo
{
    uint32_t                             controllerAxisCount;
    const GameInputLabel*                controllerAxisLabels;
    uint32_t                             controllerButtonCount;
    const GameInputLabel*                controllerButtonLabels;
    uint32_t                             controllerSwitchCount;
    const GameInputControllerSwitchInfo* controllerSwitchInfo;
};
```

### メンバー

*controllerAxisCount*\

型: uint32\_t

コントローラーの軸の数。

*controllerAxisLabels*\

型: [GameInputLabel](https://docs.xbox.com/ja-jp/reference/input/gameinput/enums/gameinputlabel.md) const \*

コントローラーの軸のラベル。

*controllerButtonCount*\

型: uint32\_t

コントローラーのボタンの数。

*controllerButtonLabels*\

型: [GameInputLabel](https://docs.xbox.com/ja-jp/reference/input/gameinput/enums/gameinputlabel.md) const \*

コントローラーのボタンのラベル。

*controllerSwitchCount*\

型: uint32\_t

コントローラーのスイッチの数。

*controllerSwitchInfo*\

型: [GameInputControllerSwitchInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md) const \*

コントローラーのスイッチに関する情報。

## 解説

`GameInputControllerInfo` 構造体のフィールドは、コントローラーに関する情報の可変サイズ配列へのポインターです。NULL ポインターは、対応する機能がコントローラーで使用できないか、サポートされていないことを示します。各配列の要素数は、構造体内の対応するフィールドによって示されます (SAL 注釈に記載されているとおり)。

この構造体は [GameInputDeviceInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) 構造体で使用されます。`GameInputDeviceInfo` は [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md) メソッドで使用されます。

詳細については、「[GameInput デバイス](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-devices.md)」を参照してください。

## 要件

**ヘッダー:** GameInput.h

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

[非推奨の GameInput API メンバー](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[GameInput の概要](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-overview.md)\


[GameInput](https://docs.xbox.com/ja-jp/reference/input/gameinput/gameinput_members.md)

## バージョン履歴

| バージョン | 変更内容 |
| - | - |
| **v4** | 削除されました。 |
| **v3** | 現在の API で導入された**新しい構造体**。v0、v1、v2 に存在していた個別の `GameInputControllerAxisInfo` 構造体と `GameInputControllerButtonInfo` 構造体を置き換えます。 |


## Related topics

- [GameInputControllerButtonInfo (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputControllerAxisInfo (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputLocation (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/enums/gameinputlocation.md)
- [GameInputDeviceInfo (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)
- [非推奨の GameInput API メンバー](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)