Estrutura JOYCAPSA (joystickapi.h)

Artigo
11/20/2024

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 fabricante e identificadores de produto.

wPid

Identificador do produto. Os identificadores de produto são definidos nofabricante e identificadores de produto .

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 máxima Z.

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 seguintes sinalizadores definem recursos individuais que um joystick pode ter:

Bandeira	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 de u-coordinate (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 (centralizados, para frente, para trás, para a esquerda e para a direita).
JOYCAPS_POVCTS	O ponto de exibição 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 identificando o OEM do driver do joystick.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	joystickapi.h (inclua Windows.h)

Consulte também

Joysticks

Estruturas de joystick multimídia

joySetCapture

Compartilhar via