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