Estrutura JOYINFOEX (joystickapi.h)

A estrutura JOYINFOEX contém informações estendidas sobre a posição do joystick, a posição do ponto de exibição e o estado do botão.

Sintaxe

typedef struct joyinfoex_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwXpos;
  DWORD dwYpos;
  DWORD dwZpos;
  DWORD dwRpos;
  DWORD dwUpos;
  DWORD dwVpos;
  DWORD dwButtons;
  DWORD dwButtonNumber;
  DWORD dwPOV;
  DWORD dwReserved1;
  DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;

Membros

dwSize

Tamanho, em bytes, dessa estrutura.

dwFlags

Sinalizadores que indicam as informações válidas retornadas nesta estrutura. Os membros que não contêm informações válidas são definidos como zero. Os seguintes sinalizadores são definidos:

Sinalizador	Descrição
JOY_RETURNALL	Equivalente a definir todos os bits JOY_RETURN, exceto JOY_RETURNRAWDATA.
JOY_RETURNBUTTONS	O membro dwButtons contém informações válidas sobre o estado de cada botão de joystick.
JOY_RETURNCENTERED	Centraliza a posição neutra do joystick para o valor médio de cada eixo de movimento.
JOY_RETURNPOV	O membro dwPOV contém informações válidas sobre o controle de ponto de exibição, expresso em unidades discretas.
JOY_RETURNPOVCTS	O membro dwPOV contém informações válidas sobre o controle de ponto de exibição expresso em unidades contínuas de centésimo grau.
JOY_RETURNR	O membro dwRpos contém dados válidos do pedal do leme. Essas informações representam outro (quarto) eixo.
JOY_RETURNRAWDATA	Os dados armazenados nessa estrutura são leituras de joystick não realçadas.
JOY_RETURNU	O membro dwUpos contém dados válidos para um quinto eixo do joystick, se esse eixo estiver disponível ou retornará zero caso contrário.
JOY_RETURNV	O membro dwVpos contém dados válidos para um sexto eixo do joystick, se esse eixo estiver disponível ou retornará zero de outra forma.
JOY_RETURNX	O membro dwXpos contém dados válidos para a coordenada x do joystick.
JOY_RETURNY	O membro dwYpos contém dados válidos para a coordenada y do joystick.
JOY_RETURNZ	O membro dwZpos contém dados válidos para a coordenada z do joystick.

 

Os sinalizadores a seguir fornecem dados para calibrar um joystick e são destinados a aplicativos de calibragem personalizados.

Sinalizador	Descrição
JOY_CAL_READ3	Leia as coordenadas x, y e z e armazene os valores brutos em dwXpos, dwYpos e dwZpos.
JOY_CAL_READ4	Leia as informações do leme e as coordenadas x, y e z e armazene os valores brutos em dwXpos, dwYpos, dwZpos e dwRpos.
JOY_CAL_READ5	Leia as informações do leme e as coordenadas x, y, z e you e armazene os valores brutos em dwXpos, dwYpos, dwZpos, dwRpos e dwUpos.
JOY_CAL_READ6	Leia os dados brutos do eixo v se um mini driver joystick estiver presente que fornecerá os dados. Retorna zero caso contrário.
JOY_CAL_READALWAYS	Leia a porta do joystick mesmo que o driver não detecte um dispositivo.
JOY_CAL_READRONLY	Leia as informações do leme se houver um mini driver joystick que fornecerá os dados e armazenará o valor bruto em dwRpos. Caso contrário, retornará zero.
JOY_CAL_READXONLY	Leia a coordenada x e armazene o valor bruto (não recalculado) em dwXpos.
JOY_CAL_READXYONLY	Lê as coordenadas x e y e coloca os valores brutos em dwXpos e dwYpos.
JOY_CAL_READYONLY	Lê a coordenada y e armazena o valor bruto em dwYpos.
JOY_CAL_READZONLY	Leia a coordenada z e armazene o valor bruto em dwZpos.
JOY_CAL_READUONLY	Leia a coordenada u se um mini driver joystick estiver presente que fornecerá os dados e armazenará o valor bruto em dwUpos. Caso contrário, retornará zero.
JOY_CAL_READVONLY	Leia a coordenada v se um mini driver joystick estiver presente que fornecerá os dados e armazenará o valor bruto em dwVpos. Caso contrário, retornará zero.

dwXpos

Coordenada X atual.

dwYpos

Coordenada Y atual.

dwZpos

Coordenada Z atual.

dwRpos

Posição atual do leme ou do quarto eixo joystick.

dwUpos

Posição atual do quinto eixo.

dwVpos

Posição atual do sexto eixo.

dwButtons

Estado atual dos botões de joystick 32. O valor desse membro pode ser definido como qualquer combinação de JOY_BUTTON n sinalizadores, em que n é um valor no intervalo de 1 a 32 correspondente ao botão que é pressionado.

dwButtonNumber

Número do botão atual que é pressionado.

dwPOV

Posição atual do controle de ponto de exibição. Os valores desse membro estão no intervalo de 0 a 35.900. Esses valores representam o ângulo, em graus, de cada exibição multiplicada por 100.

dwReserved1

Reservado; não use.

dwReserved2

Reservado; não use.

Comentários

O valor do membro dwSize também é usado para identificar o número de versão da estrutura quando ela é passada para a função joyGetPosEx .

A maioria dos dispositivos com um controle de ponto de exibição tem apenas cinco posições. Quando o sinalizador JOY_RETURNPOV é definido, essas posições são relatadas usando as seguintes constantes:

Sinalizador de ponto de exibição	Descrição
JOY_POVBACKWARD	O chapéu de ponto de vista é pressionado para trás. O valor 18.000 representa uma orientação de 180,00 graus (para trás).
JOY_POVCENTERED	O chapéu de ponto de vista está na posição neutra. O valor -1 significa que o chapéu de ponto de vista não tem ângulo para relatar.
JOY_POVFORWARD	O chapéu de ponto de vista é pressionado para a frente. O valor 0 representa uma orientação de 0,00 graus (logo à frente).
JOY_POVLEFT	O chapéu de ponto de vista está sendo pressionado à esquerda. O valor 27.000 representa uma orientação de 270,00 graus (90,00 graus à esquerda).
JOY_POVRIGHT	O chapéu de ponto de vista é pressionado à direita. O valor 9.000 representa uma orientação de 90,00 graus (à direita).

 

Atualmente, o driver de joystick padrão dá suporte a essas cinco direções discretas. Se um aplicativo puder aceitar apenas os valores de ponto de exibição definidos, ele deverá usar o sinalizador JOY_RETURNPOV. Se um aplicativo puder aceitar outras leituras de grau, ele deverá usar o sinalizador JOY_RETURNPOVCTS para obter dados contínuos se estiver disponível. O sinalizador JOY_RETURNPOVCTS também dá suporte às constantes JOY_POV usadas com o sinalizador JOY_RETURNPOV.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	joystickapi.h (inclua Windows.h)

Confira também

Joysticks

Estruturas joystick multimídia

joyGetPosEx