Struttura DIDEVICESTATE (dinputd.h)

Articolo
08/23/2023

La struttura DIDEVICESTATE restituisce informazioni sullo stato di un dispositivo di force feedback.

Sintassi

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

Members

dwSize

Specifica le dimensioni della struttura in byte. Questo membro deve essere inizializzato prima dell'utilizzo della struttura.

dwState

Indica vari aspetti dello stato del dispositivo. Può indicare zero, uno o più degli elementi seguenti:

DIGFFS_EMPTY

Indica che il dispositivo force feedback è privo di effetti scaricati.

DIGFFS_STOPPED

Indica che non è in corso la riproduzione di alcun effetto e che il dispositivo non è in pausa.

DIGFFS_PAUSED

Indica che la riproduzione degli effetti è stata sospesa da un comando DISFFC_PAUSE precedente.

DIGFFS_ACTUATORSON

Indica che gli attuatori force-feedback del dispositivo sono abilitati.

DIGFFS_ACTUATORSOFF

Indica che gli attuatori force-feedback del dispositivo sono disabilitati.

DIGFFS_POWERON

Indica che la potenza del sistema force-feedback è attualmente disponibile. Se il dispositivo non può segnalare lo stato di alimentazione, non devono essere restituiti né DIGFFS_POWERON né DIGFFS_POWEROFF.

DIGFFS_POWEROFF

Indica che la potenza del sistema force-feedback non è attualmente disponibile. Se il dispositivo non può segnalare lo stato di alimentazione, non devono essere restituiti né DIGFFS_POWERON né DIGFFS_POWEROFF.

DIGFFS_SAFETYSWITCHON

Indica che il commutatore di sicurezza (interruttore di tipo dead-man) è attualmente attivato, ovvero che il dispositivo può funzionare. Se il dispositivo non può segnalare lo stato del commutatore di sicurezza, non devono essere restituiti né DIGFFS_SAFETYSWITCHON né DIGFFS_SAFETYSWITCHOFF.

DIGFFS_SAFETYSWITCHOFF

Indica che il commutatore di sicurezza (interruttore di tipo dead-man) è attualmente disattivato, il che significa che il dispositivo non può funzionare. Se il dispositivo non può segnalare lo stato del commutatore di sicurezza, non devono essere restituiti né DIGFFS_SAFETYSWITCHON né DIGFFS_SAFETYSWITCHOFF.

DIGFFS_USERFFSWITCHON

Indica che l'opzione force-feedback dell'utente è attualmente attivata, vale a dire che il dispositivo può funzionare. Se il dispositivo non può segnalare lo stato dell'opzione force-feedback dell'utente, non devono essere restituiti né DIGFFS_USERFFSWITCHON né DIGFFS_USERFFSWITCHOFF.

DIGFFS_USERFFSWITCHOFF

Indica che l'opzione force-feedback dell'utente è attualmente disattivata, ovvero che il dispositivo non può funzionare. Se il dispositivo non può segnalare lo stato dell'opzione force-feedback dell'utente, non devono essere restituiti né DIGFFS_USERFFSWITCHON né DIGFFS_USERFFSWITCHOFF.

DIGFFS_DEVICELOST

Indica che il dispositivo ha subito un errore imprevisto e si trova in uno stato indeterminato. Deve essere reimpostato non verificando e riacquisendo il dispositivo oppure inviando in modo esplicito un comando DISFFC_RESET. Ad esempio, il dispositivo potrebbe andare perso se l'utente sospende il computer, causando la perdita di memoria su scheda nel dispositivo.

dwLoad

Valore che indica la percentuale di memoria del dispositivo in uso. Il valore zero indica che la memoria del dispositivo è completamente disponibile. Il valore 100 indica che il dispositivo è pieno.

Requisiti

Requisito	Valore
Intestazione	dinputd.h

Condividi tramite