Skip to main content

IGameInput::CreateAggregateDevice

指定された GameInputKind のすべての入力を集約する仮想 IGameInputDevice インスタンスを作成します。

構文

パラメーター

inputKind   _In_
型: GameInputKind
返される仮想 IGameInputDevice が読み取り値を集約する入力のタイプ。 deviceId   _Out_
型: APP_LOCAL_DEVICE_ID*
集約デバイスの結果として得られるデバイス識別子。

戻り値

型: HRESULT 関数の結果。サポートされていない GameInputKind が使用された場合、または GameInputKind フラグを組み合わせようとした場合、失敗が返されます。

解説

CreateAggregateDevice に使用する入力種別は、GameInputKind 列挙型からの単一の値である必要があります。GameInputKind フラグの組み合わせはサポートされていません。アプリケーションが複数の入力種別の集約入力を必要とする場合、それぞれに対して仮想 IGameInputDevice インスタンスを作成する必要があります。
この関数は、DisableAggregateDevice を呼び出して無効化された可能性のある集約デバイスを再度有効にするために使用されます。別のインスタンスを作成するのではなく、デバイスが再度有効になります。
集約デバイスは、RegisterDeviceCallback を呼び出して登録されたコールバックを通じてステータス通知も発行します。 集約は次の入力種別に対してのみサポートされます:
  • GameInputKindKeyboard
  • GameInputKindMouse
  • GameInputKindArcadeStick
  • GameInputKindFlightStick
  • GameInputKindGamepad
  • GameInputKindRacingWheel

要件

ヘッダー: GameInput.h Input API の概要
IGameInput

バージョン履歴

最終更新日 2026年8月13日