構文
パラメーター
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
