DIDEVICESTATE 구조체(dinputd.h)

아티클
08/23/2023

DIDEVICESTATE 구조체는 힘 피드백 디바이스의 상태에 대한 정보를 반환합니다.

구문

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

멤버

dwSize

구조체의 크기를 바이트 단위로 지정합니다. 구조체를 사용하려면 먼저 이 멤버를 초기화해야 합니다.

dwState

디바이스 상태의 다양한 측면을 나타냅니다. 다음 중 0개, 1개 이상을 나타낼 수 있습니다.

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

사용 중인 디바이스 메모리의 백분율을 나타내는 값입니다. 값이 0이면 디바이스 메모리를 완전히 사용할 수 있음을 나타냅니다. 값 100은 디바이스가 가득 찼다는 것을 나타냅니다.

요구 사항

요구 사항	값
헤더	dinputd.h

Share via