Estrutura DIDEVICESTATE (dinputd.h)

Artigo
08/23/2023

A estrutura DIDEVICESTATE retorna informações sobre o estado de um dispositivo de force feedback.

Sintaxe

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

Membros

dwSize

Especifica o tamanho da estrutura em bytes. Esse membro deve ser inicializado antes que a estrutura seja usada.

dwState

Indica vários aspectos do estado do dispositivo. Pode indicar zero, um ou mais dos seguintes:

DIGFFS_EMPTY

Indica que o dispositivo force feedback é desprovido de quaisquer efeitos baixados.

DIGFFS_STOPPED

Indica que nenhum efeito está sendo reproduzido no momento e que o dispositivo não está em pausa.

DIGFFS_PAUSED

Indica que a reprodução de efeitos foi pausada por um comando DISFFC_PAUSE anterior.

DIGFFS_ACTUATORSON

Indica que os atuadores de force-feedback do dispositivo estão habilitados.

DIGFFS_ACTUATORSOFF

Indica que os atuadores de force-feedback do dispositivo estão desabilitados.

DIGFFS_POWERON

Indica que a energia para o sistema de force-feedback está disponível no momento. Se o dispositivo não puder relatar o estado de energia, nem DIGFFS_POWERON nem DIGFFS_POWEROFF deverão ser retornados.

DIGFFS_POWEROFF

Indica que a energia para o sistema de force-feedback não está disponível no momento. Se o dispositivo não puder relatar o estado de energia, nem DIGFFS_POWERON nem DIGFFS_POWEROFF deverão ser retornados.

DIGFFS_SAFETYSWITCHON

Indica que o comutador de segurança (comutador de homem morto) está ativado no momento, o que significa que o dispositivo pode operar. Se o dispositivo não puder relatar o estado do comutador de segurança, nem DIGFFS_SAFETYSWITCHON nem DIGFFS_SAFETYSWITCHOFF devem ser retornados.

DIGFFS_SAFETYSWITCHOFF

Indica que o comutador de segurança (comutador de homem morto) está desativado no momento, o que significa que o dispositivo não pode operar. Se o dispositivo não puder relatar o estado do comutador de segurança, nem DIGFFS_SAFETYSWITCHON nem DIGFFS_SAFETYSWITCHOFF devem ser retornados.

DIGFFS_USERFFSWITCHON

Indica que a opção force-feedback do usuário está ativada no momento, o que significa que o dispositivo pode operar. Se o dispositivo não puder relatar o estado da opção force-feedback do usuário, nem DIGFFS_USERFFSWITCHON nem DIGFFS_USERFFSWITCHOFF devem ser retornados.

DIGFFS_USERFFSWITCHOFF

Indica que a opção force-feedback do usuário está desativada no momento, o que significa que o dispositivo não pode operar. Se o dispositivo não puder relatar o estado da opção force-feedback do usuário, nem DIGFFS_USERFFSWITCHON nem DIGFFS_USERFFSWITCHOFF devem ser retornados.

DIGFFS_DEVICELOST

Indica que o dispositivo sofreu uma falha inesperada e está em um estado indeterminado. Ele deve ser redefinido desaquivando e reacessando o dispositivo ou enviando explicitamente um comando DISFFC_RESET. Por exemplo, o dispositivo poderá ser perdido se o usuário suspender o computador, fazendo com que a memória a bordo no dispositivo seja perdida.

dwLoad

Um valor que indica o percentual de memória do dispositivo em uso. Um valor zero indica que a memória do dispositivo está completamente disponível. Um valor de 100 indica que o dispositivo está cheio.

Requisitos

Requisito	Valor
Cabeçalho	dinputd.h

Compartilhar via