Structure DIDEVICESTATE (dinputd.h)

La structure DIDEVICESTATE retourne des informations sur l’état d’un appareil de rétroaction de force.

Syntaxe

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

Membres

dwSize

Spécifie la taille de la structure en octets. Ce membre doit être initialisé avant l’utilisation de la structure.

dwState

Indique différents aspects de l’état de l’appareil. Peut indiquer zéro, un ou plusieurs des éléments suivants :

DIGFFS_EMPTY

Indique que l’appareil de retour de force est dépourvu d’effets téléchargés.

DIGFFS_STOPPED

Indique qu’aucun effet n’est en cours de lecture et que l’appareil n’est pas suspendu.

DIGFFS_PAUSED

Indique que la lecture des effets a été interrompue par une commande DISFFC_PAUSE précédente.

DIGFFS_ACTUATORSON

Indique que les actionneurs de retour de force de l’appareil sont activés.

DIGFFS_ACTUATORSOFF

Indique que les actionneurs de retour de force de l’appareil sont désactivés.

DIGFFS_POWERON

Indique que l’alimentation du système de retour de force est actuellement disponible. Si l’appareil ne peut pas signaler l’état d’alimentation, ni DIGFFS_POWERON ni DIGFFS_POWEROFF ne doivent être retournés.

DIGFFS_POWEROFF

Indique que l’alimentation du système de retour de force n’est pas disponible actuellement. Si l’appareil ne peut pas signaler l’état d’alimentation, ni DIGFFS_POWERON ni DIGFFS_POWEROFF ne doivent être retournés.

DIGFFS_SAFETYSWITCHON

Indique que le commutateur de sécurité (commutateur d’homme mort) est actuellement activé, ce qui signifie que l’appareil peut fonctionner. Si l’appareil ne peut pas signaler l’état du commutateur de sécurité, ni DIGFFS_SAFETYSWITCHON ni DIGFFS_SAFETYSWITCHOFF ne doivent être retournés.

DIGFFS_SAFETYSWITCHOFF

Indique que le commutateur de sécurité (commutateur d’homme mort) est actuellement désactivé, ce qui signifie que l’appareil ne peut pas fonctionner. Si l’appareil ne peut pas signaler l’état du commutateur de sécurité, ni DIGFFS_SAFETYSWITCHON ni DIGFFS_SAFETYSWITCHOFF ne doivent être retournés.

DIGFFS_USERFFSWITCHON

Indique que le commutateur de retour forcé de l’utilisateur est actuellement activé, ce qui signifie que l’appareil peut fonctionner. Si l’appareil ne peut pas signaler l’état du commutateur de retour forcé de l’utilisateur, ni DIGFFS_USERFFSWITCHON ni DIGFFS_USERFFSWITCHOFF ne doivent être retournés.

DIGFFS_USERFFSWITCHOFF

Indique que le commutateur de retour forcé de l’utilisateur est actuellement désactivé, ce qui signifie que l’appareil ne peut pas fonctionner. Si l’appareil ne peut pas signaler l’état du commutateur de retour forcé de l’utilisateur, ni DIGFFS_USERFFSWITCHON ni DIGFFS_USERFFSWITCHOFF ne doivent être retournés.

DIGFFS_DEVICELOST

Indique que l’appareil a subi une défaillance inattendue et qu’il est dans un état indéterminé. Il doit être réinitialisé en désinténuant et en réacquistant l’appareil, ou en envoyant explicitement une commande DISFFC_RESET. Par exemple, l’appareil peut être perdu si l’utilisateur suspend l’ordinateur, ce qui entraîne la perte de la mémoire embarquée sur l’appareil.

dwLoad

Valeur indiquant le pourcentage de mémoire de l’appareil en cours d’utilisation. La valeur zéro indique que la mémoire de l’appareil est entièrement disponible. La valeur 100 indique que l’appareil est plein.

Configuration requise

Condition requise	Valeur
En-tête	dinputd.h