IGameInputDevice (v1)

代表输入设备。 此接口中的方法可用于识别游戏输入设备并且与游戏输入设备进行交互。 您可以查询与设备有关的信息,例如其类型、功能和电池状态。 您还可以激活某些设备特定的硬件,例如触觉回馈和力回馈。

语法

class IGameInputDevice : public IUnknown

方法

方法 说明
CreateForceFeedbackEffect 利用 IGameInputForceFeedbackEffect 接口跟踪马达上的力回馈效果。
GetDeviceInfo 提供有关输入设备的完整属性和功能的静态信息。
GetDeviceStatus 获取输入设备的当前状态。
IsForceFeedbackMotorPoweredOn 显示是否打开了特定的力回馈马达。
SetForceFeedbackMotorGain 为电机上的所有加载效果设置全局衰减因子。
SetRumbleState 调整设备上四个隆隆电机的所需强度。

备注

IGameInputDevice 接口使应用程序可以访问有关输入设备属性、功能和当前状态的丰富信息。 它还提供对高级功能(如力回馈和触觉反馈)的访问。 许多应用程序从不需要在此接口上调用 方法,仅使用 IGameInputDevice 实例作为简单的设备标识符来筛选来自输入流的读取。

与实例一样 IGameInputReading ,每个 IGameInputDevice 实例都是单一实例;多次检索同一设备只会增加基础对象的引用计数。 因此, IGameInputDevice 可以比较实例的引用相等性。

在基础设备与系统断开连接后,应用程序可能会继续保留对 IGameInputDevice 实例的引用, (有意或无意) 。 实例 IGameInputDevice 仍然有效,因为无法强制应用程序释放对 接口的引用,但基础对象进入僵尸状态。

处于僵尸状态时,接口上 IGameInputDevice 返回静态配置信息或设备状态信息的任何方法通常 (仍可调用,Get* 方法) 。 但是,任何修改设备状态或以某种方式要求连接设备的方法都会返回一个故障 HRESULT ,指示设备不再连接。 如果之后将同一物理设备重新连接到系统,则僵尸设备对象将恢复,并且实例上 IGameInputDevice 的所有方法将再次正常运行。

要求

头文件:GameInput.h

支持的平台: 窗户

另请参阅

输入 API 概述GameInput