Struktur DIDEVICESTATE (dinputd.h)

Struktur DIDEVICESTATE mengembalikan informasi tentang status perangkat umpan balik paksa.

Sintaks

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

Anggota

dwSize

Menentukan ukuran struktur dalam byte. Anggota ini harus diinisialisasi sebelum struktur digunakan.

dwState

Menunjukkan berbagai aspek status perangkat. Dapat menunjukkan nol, satu, atau beberapa hal berikut:

DIGFFS_EMPTY

Menunjukkan bahwa perangkat umpan balik paksa tidak memiliki efek yang diunduh.

DIGFFS_STOPPED

Menunjukkan bahwa tidak ada efek yang saat ini diputar dan perangkat tidak dijeda.

DIGFFS_PAUSED

Menunjukkan bahwa pemutaran efek telah dijeda oleh perintah DISFFC_PAUSE sebelumnya.

DIGFFS_ACTUATORSON

Menunjukkan bahwa aktuator umpan balik paksa perangkat diaktifkan.

DIGFFS_ACTUATORSOFF

Menunjukkan bahwa aktuator umpan balik paksa perangkat dinonaktifkan.

DIGFFS_POWERON

Menunjukkan bahwa daya ke sistem force-feedback saat ini tersedia. Jika perangkat tidak dapat melaporkan status daya, maka tidak DIGFFS_POWERON atau DIGFFS_POWEROFF harus dikembalikan.

DIGFFS_POWEROFF

Menunjukkan bahwa daya ke sistem force-feedback saat ini tidak tersedia. Jika perangkat tidak dapat melaporkan status daya, maka tidak DIGFFS_POWERON atau DIGFFS_POWEROFF harus dikembalikan.

DIGFFS_SAFETYSWITCHON

Menunjukkan bahwa sakelar keamanan (sakelar orang mati) saat ini menyala, yang berarti bahwa perangkat dapat beroperasi. Jika perangkat tidak dapat melaporkan status sakelar keamanan, maka baik DIGFFS_SAFETYSWITCHON maupun DIGFFS_SAFETYSWITCHOFF tidak boleh dikembalikan.

DIGFFS_SAFETYSWITCHOFF

Menunjukkan bahwa sakelar keamanan (sakelar orang mati) saat ini mati, yang berarti bahwa perangkat tidak dapat beroperasi. Jika perangkat tidak dapat melaporkan status sakelar keamanan, maka baik DIGFFS_SAFETYSWITCHON maupun DIGFFS_SAFETYSWITCHOFF tidak boleh dikembalikan.

DIGFFS_USERFFSWITCHON

Menunjukkan bahwa sakelar umpan balik paksa pengguna saat ini aktif, yang berarti bahwa perangkat dapat beroperasi. Jika perangkat tidak dapat melaporkan status sakelar umpan balik paksa pengguna, maka tidak DIGFFS_USERFFSWITCHON atau DIGFFS_USERFFSWITCHOFF harus dikembalikan.

DIGFFS_USERFFSWITCHOFF

Menunjukkan bahwa sakelar umpan balik paksa pengguna saat ini nonaktif, yang berarti bahwa perangkat tidak dapat beroperasi. Jika perangkat tidak dapat melaporkan status sakelar umpan balik paksa pengguna, maka tidak DIGFFS_USERFFSWITCHON atau DIGFFS_USERFFSWITCHOFF harus dikembalikan.

DIGFFS_DEVICELOST

Menunjukkan bahwa perangkat mengalami kegagalan tak terduga dan dalam keadaan tidak ditentukan. Ini harus diatur ulang baik dengan tidak memerlukan dan memperoleh kembali perangkat, atau dengan secara eksplisit mengirim perintah DISFFC_RESET. Misalnya, perangkat mungkin hilang jika pengguna menangguhkan komputer, menyebabkan memori on-board pada perangkat hilang.

dwLoad

Nilai yang menunjukkan persentase memori perangkat yang digunakan. Nilai nol menunjukkan bahwa memori perangkat sepenuhnya tersedia. Nilai 100 menunjukkan bahwa perangkat penuh.

Persyaratan