Estrutura JOYCAPSA (joystickapi.h)

A estrutura JOYCAPS contém informações sobre os recursos do joystick.

Sintaxe

typedef struct tagJOYCAPSA {
  WORD wMid;
  WORD wPid;
  CHAR szPname[MAXPNAMELEN];
  UINT wXmin;
  UINT wXmax;
  UINT wYmin;
  UINT wYmax;
  UINT wZmin;
  UINT wZmax;
  UINT wNumButtons;
  UINT wPeriodMin;
  UINT wPeriodMax;
  UINT wRmin;
  UINT wRmax;
  UINT wUmin;
  UINT wUmax;
  UINT wVmin;
  UINT wVmax;
  UINT wCaps;
  UINT wMaxAxes;
  UINT wNumAxes;
  UINT wMaxButtons;
  CHAR szRegKey[MAXPNAMELEN];
  CHAR szOEMVxD[MAX_JOYSTICKOEMVXDNAME];
} JOYCAPSA, *PJOYCAPSA, *NPJOYCAPSA, *LPJOYCAPSA;

Membros

wMid

Identificador do fabricante. Os identificadores do fabricante são definidos em Identificadores de Fabricante e Produto.

wPid

Identificador do produto. Os identificadores de produto são definidos em Identificadores de Produto e Fabricante.

szPname[MAXPNAMELEN]

Cadeia de caracteres terminada em nulo que contém o nome do produto joystick.

wXmin

Coordenada X mínima.

wXmax

Coordenada X máxima.

wYmin

Coordenada mínima Y.

wYmax

Coordenada máxima Y.

wZmin

Coordenada Z mínima.

wZmax

Coordenada Z máxima.

wNumButtons

Número de botões de joystick.

wPeriodMin

Menor frequência de sondagem com suporte quando capturada pela função joySetCapture .

wPeriodMax

Maior frequência de sondagem com suporte quando capturada por joySetCapture.

wRmin

Valor mínimo do leme. O leme é um quarto eixo de movimento.

wRmax

Valor máximo do leme. O leme é um quarto eixo de movimento.

wUmin

Valores mínimos de coordenada u (quinto eixo).

wUmax

Valores máximos de coordenada u (quinto eixo).

wVmin

Valores mínimos de coordenada v (sexto eixo).

wVmax

Valores máximos de coordenada v (sexto eixo).

wCaps

Funcionalidades do Joystick Os sinalizadores a seguir definem funcionalidades individuais que um joystick pode ter:

Sinalizador	Descrição
JOYCAPS_HASZ	O Joystick tem informações de coordenadas z.
JOYCAPS_HASR	O Joystick tem informações de leme (quarto eixo).
JOYCAPS_HASU	O Joystick tem informações sobre a coordenada u (quinto eixo).
JOYCAPS_HASV	O Joystick tem informações de coordenada v (sexto eixo).
JOYCAPS_HASPOV	O Joystick tem informações de ponto de exibição.
JOYCAPS_POV4DIR	O ponto de vista do Joystick dá suporte a valores discretos (centralizado, para frente, para trás, para a esquerda e para a direita).
JOYCAPS_POVCTS	O ponto de vista do Joystick dá suporte a rolamentos de grau contínuos.

wMaxAxes

Número máximo de eixos compatíveis com o joystick.

wNumAxes

Número de eixos atualmente em uso pelo joystick.

wMaxButtons

Número máximo de botões compatíveis com o joystick.

szRegKey[MAXPNAMELEN]

Cadeia de caracteres terminada em nulo que contém a chave do Registro para o joystick.

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

Cadeia de caracteres terminada em nulo que identifica o OEM do driver do joystick.

Comentários

Observação

O cabeçalho joystickapi.h define JOYCAPS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

joySetCapture