メインコンテンツへスキップ
入力デバイスに割り当てられている XInput ユーザー インデックスがあれば、それを取得します。

構文

パラメーター

index   _Out_
型: uint32_t*
デバイスの 0 から始まる XInput ユーザー インデックス (0 ~ 3) を受け取ります。デバイスに XInput ユーザー インデックスがない場合は 0 に設定されます。

戻り値

型: bool デバイスに現在 XInput ユーザー インデックスがある場合は true。それ以外の場合は false。

解説

XInput ユーザー インデックスは、XInput API がコントローラーを識別するために使用するコントローラー スロットで、通常はコントローラーに表示されるプレイヤー インジケーターに対応します。このメソッドを使用すると、GameInput デバイスを、XInput で同じユーザー インデックスが参照するコントローラーと関連付けることができます。たとえば、タイトルを XInput から GameInput へコントローラー 1 台ずつ移行する場合に使用します。 ユーザー インデックスを持つのは、XInput を通じて公開されるデバイスのみです。キーボード、マウス、ほとんどの HID ゲーム コントローラーなど、その他のデバイスは false を返します。集約デバイスが XInput ユーザー インデックスを持つことはありません。デバイスが切断されると、そのユーザー インデックスは解放され、メソッドは false を返します。 ほとんどのデバイス プロパティとは異なり、XInput ユーザー インデックスはデバイスの接続中に変化することがあります。変化すると、GameInput は登録されたデバイス コールバックに GameInputDeviceEvent の GameInputDeviceEventXInputIndexUpdated 値で通知します。新しいインデックスを取得するには、コールバック内から GetXInputDeviceIndex をもう一度呼び出します。

要件

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

関連項目

GameInput の概要
IGameInputDevice
GameInputDeviceEvent
IGameInput::RegisterDeviceCallback

バージョン履歴

最終更新日 2026年11月6日