Структура DIDEVICESTATE (dinputd.h)

Статья
02/28/2024

Структура 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

Указывает, что переключатель безопасности (переключатель dead-man) в настоящее время включен, что означает, что устройство может работать. Если устройство не может сообщить о состоянии переключателя безопасности, не следует возвращать ни DIGFFS_SAFETYSWITCHON, ни DIGFFS_SAFETYSWITCHOFF.

DIGFFS_SAFETYSWITCHOFF

Указывает, что переключатель безопасности (переключатель dead-man) в настоящее время отключен, что означает, что устройство не может работать. Если устройство не может сообщить о состоянии переключателя безопасности, не следует возвращать ни DIGFFS_SAFETYSWITCHON, ни DIGFFS_SAFETYSWITCHOFF.

DIGFFS_USERFFSWITCHON

Указывает, что переключатель принудительной обратной связи пользователя в настоящее время включен, что означает, что устройство может работать. Если устройство не может сообщить о состоянии переключателя принудительной обратной связи пользователя, не следует возвращать ни DIGFFS_USERFFSWITCHON, ни DIGFFS_USERFFSWITCHOFF.

DIGFFS_USERFFSWITCHOFF

Указывает, что переключатель принудительной обратной связи пользователя в настоящее время отключен, что означает, что устройство не может работать. Если устройство не может сообщить о состоянии переключателя принудительной обратной связи пользователя, не следует возвращать ни DIGFFS_USERFFSWITCHON, ни DIGFFS_USERFFSWITCHOFF.

DIGFFS_DEVICELOST

Указывает, что устройство произошло из-за непредвиденного сбоя и находится в неопределенном состоянии. Его необходимо сбросить либо путем отмены и повторного получения устройства, либо путем явной отправки команды DISFFC_RESET. Например, устройство может быть потеряно, если пользователь приостанавливает работу компьютера, что приводит к потере встроенной памяти на устройстве.

dwLoad

Значение , указывающее процент используемой памяти устройства. Нулевое значение указывает, что память устройства полностью доступна. Значение 100 указывает, что устройство заполнено.

Требования

Требование	Значение
Заголовок	dinputd.h

Поделиться через