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 表示裝置已滿。

規格需求

需求	值
標頭	dinputd.h

共用方式為