Share via

Função joyGetPosEx (joystickapi.h)

  • Artigo

A função joyGetPosEx consulta um joystick para sua posição e status de botão.

Sintaxe

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Parâmetros

uJoyID

Identificador do joystick a ser consultado. Os valores válidos para uJoyID variam de zero (JOYSTICKID1) a 15.

pji

Ponteiro para uma estrutura JOYINFOEX que contém informações de posição estendida e status de botão do joystick. Você deve definir os membros dwSize e dwFlags ou joyGetPosEx falhará. As informações retornadas de joyGetPosEx dependem dos sinalizadores especificados em dwFlags.

Retornar valor

Retorna JOYERR_NOERROR se tiver êxito ou um dos valores de erro a seguir.

Código de retorno Descrição
MMSYSERR_NODRIVER
 O joystick driver não está presente.
MMSYSERR_INVALPARAM
 Um parâmetro inválido foi passado.
MMSYSERR_BADDEVICEID
 O identificador de joystick especificado é inválido.
JOYERR_UNPLUGGED
 O joystick especificado não está conectado ao sistema.
JOYERR_PARMS
 O identificador de joystick especificado é inválido.

Comentários

Essa função fornece acesso a dispositivos estendidos, como pedais de leme, chapéus de ponto de vista, dispositivos com um grande número de botões e sistemas de coordenadas usando até seis eixos. Para dispositivos joystick que usam três eixos ou menos e têm menos de quatro botões, use a função joyGetPos .

Requisitos

Requisito Valor
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]
Plataforma de Destino Windows
Cabeçalho joystickapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Joysticks

Funções joystick multimídia