DIDEVICESTATE 结构 (dinputd.h)

项目
08/23/2023

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

通过