DIDEVICESTATE 结构 (dinputd.h)

DIDEVICESTATE 结构返回有关力回馈设备状态的信息。

语法

typedef struct DIDEVICESTATE {
  DWORD dwSize;
  DWORD dwState;
  DWORD dwLoad;
} DIDEVICESTATE, *LPDIDEVICESTATE;

成员

dwSize

指定结构的大小(以字节为单位)。 必须先初始化此成员,然后才能使用结构。

dwState

指示设备状态的各个方面。 可以指示以下零项、一项或多项:

DIGFFS_EMPTY

指示力回馈设备没有任何下载效果。

DIGFFS_STOPPED

指示当前未播放任何效果,并且设备未暂停。

DIGFFS_PAUSED

指示上一个DISFFC_PAUSE命令已暂停播放效果。

DIGFFS_ACTUATORSON

指示设备的力回馈执行器已启用。

DIGFFS_ACTUATORSOFF

指示设备的力回馈执行器已禁用。

DIGFFS_POWERON

指示力回馈系统的电源当前可用。 如果设备无法报告电源状态,则不应返回DIGFFS_POWERON和DIGFFS_POWEROFF。

DIGFFS_POWEROFF

指示力回馈系统的电源当前不可用。 如果设备无法报告电源状态,则不应返回DIGFFS_POWERON和DIGFFS_POWEROFF。

DIGFFS_SAFETYSWITCHON

指示安全开关 (死人开关) 当前处于打开状态,这意味着设备可以运行。 如果设备无法报告安全开关的状态,则不应返回DIGFFS_SAFETYSWITCHON和DIGFFS_SAFETYSWITCHOFF。

DIGFFS_SAFETYSWITCHOFF

指示安全开关 (死人开关) 当前处于关闭状态,这意味着设备无法运行。 如果设备无法报告安全开关的状态,则不应返回DIGFFS_SAFETYSWITCHON和DIGFFS_SAFETYSWITCHOFF。

DIGFFS_USERFFSWITCHON

指示用户强制反馈开关当前处于打开状态,这意味着设备可以运行。 如果设备无法报告用户强制反馈开关的状态,则不应返回DIGFFS_USERFFSWITCHON和DIGFFS_USERFFSWITCHOFF。

DIGFFS_USERFFSWITCHOFF

指示用户强制反馈开关当前已关闭,这意味着设备无法运行。 如果设备无法报告用户强制反馈开关的状态,则不应返回DIGFFS_USERFFSWITCHON和DIGFFS_USERFFSWITCHOFF。

DIGFFS_DEVICELOST

指示设备发生意外故障,并处于不确定状态。 它必须通过取消获取和重新获取设备或通过显式发送DISFFC_RESET命令来重置。 例如,如果用户暂停计算机,则设备可能会丢失,从而导致设备上的板载内存丢失。

dwLoad

一个指示正在使用的设备内存百分比的值。 值为零表示设备内存完全可用。 值为 100 表示设备已满。

要求

要求
Header dinputd.h