入力デバイスを表します。 このインターフェイスのメソッドでは、ゲーム入力デバイスを識別して操作することができます。 種類、機能、バッテリーの状態など、デバイスに関する情報をクエリできます。 触覚フィードバックやフォース フィードバックなど、一部のデバイス固有のハードウェアをアクティブ化することもできます。 これらのメソッドでは、デバイスへの排他的アクセス権を得ることもできます。
注意
Xbox ではなく Windows 用に開発している場合は、GameInput v.1 API にアップグレードすることができます。最新バージョンですが、本体との互換性は 1:1 ではありません。
構文
class IGameInputDevice : public IUnknown
メソッド
| メソッド | 説明 |
|---|---|
| AcquireExclusiveRawDeviceAccess | IGameInputDevice AcquireExclusiveRawDeviceAccess API リファレンス |
| CreateForceFeedbackEffect | IGameInputForceFeedbackEffect インターフェイスを使用して、モーターに作用するフォース フィードバック効果を追跡します。 |
| CreateRawDeviceReport | IGameInputRawDeviceReport インスタンスによって表される新しいバッファーを作成します。 |
| ExecuteRawDeviceIoControl | IOCTL を基になるデバイスまたはそのドライバーに送信します。 |
| GetBatteryState | デバイスのバッテリー状態を取得します。 |
| GetDeviceInfo | 入力デバイスのすべてのプロパティと機能に関する静的情報にアクセスします。 |
| GetDeviceStatus | 入力デバイスの現在状態を取得します。 |
| GetRawDeviceFeature | HID デバイスから機能レポートをクエリします。 |
| IsForceFeedbackMotorPoweredOn | 特定のフォース フィードバック モーターの電源がオンになっているかどうかを示します。 |
| PowerOff | 入力デバイスの電源をオフにします。 |
| ReleaseExclusiveRawDeviceAccess | IGameInputDevice ReleaseExclusiveRawDeviceAccess API リファレンス |
| SendInputSynchronizationHint | ゲーム入力デバイスが使用可能になるタイミングを判断するために、作成された GameInput API の呼び出しを分析します。 |
| SendRawDeviceOutput | デバイスに生データを送信します。 |
| SetForceFeedbackMotorGain | モーターに読み込まれているすべての効果にグローバル減衰係数を適用します。 |
| SetHapticMotorState | デバイス上の触覚モーターに波形を送信します。 |
| SetInputSynchronizationState | IGameInputDevice::SetInputSynchronizationState |
| SetRawDeviceFeature | HID デバイスに機能レポートを送信します。 |
| SetRumbleState | デバイス上の 4 つの振動モーターに必要な強度を設定します。 |
解説
IGameInputDevice インターフェイスを使用すると、アプリケーションは入力デバイスのプロパティ、機能、現在の状態に関する豊富な情報にアクセスできます。 また、フォース フィードバックや触覚フィードバックなどの高度な機能と、デバイスへの低レベルの I/O (IOCTL など) を実行する機能へのアクセス権も付与されます。 多くのアプリケーションは、このインターフェイスのメソッドを呼び出す必要はなく、入力ストリームからの読み取り値をフィルター処理するためのシンプルなデバイス識別子として IGameInputDevice インスタンスを使用するだけです。
IGameInputReading インスタンスと同様に、すべての IGameInputDevice インスタンスはシングルトンです。同じデバイスを複数回取得すると、基盤となるオブジェクトの参照回数が単純にインクリメントされます。 そのため、IGameInputDevice インスタンスを比較して参照の等価性を確認できます。
基盤となるデバイスがシステムから切断された後、アプリケーションは (意図的に、または意図せず) IGameInputDevice インスタンスへの参照を引き続き保持することがあります。 アプリケーションにインターフェイスへの参照の解放を強制することはできないため IGameInputDevice インスタンスは有効なままになりますが、基盤となるオブジェクトはゾンビ状態になります。
ゾンビ状態の場合、静的構成情報またはデバイス状態情報を返す IGameInputDevice インターフェイスのメソッドは呼び出し可能なままになります (一般に、Get* メソッド)。 ただし、デバイスの状態を変更するメソッド、またはなんらかの方法でデバイスの接続を要求するメソッドは、デバイスが接続されなくなったことを示す失敗 HRESULT を返します。 後で同じ物理デバイスがシステムに再接続された場合、ゾンビ デバイス オブジェクトが復活し、IGameInputDevice インスタンス上のすべてのメソッドが再び機能します。
要件
ヘッダー: GameInput.h
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体