Función joyGetPosEx (joystickapi.h)

La función joyGetPosEx consulta un joystick para su posición y estado del botón.

Sintaxis

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Parámetros

uJoyID

Identificador del joystick que se va a consultar. Valores válidos para el intervalo uJoyID de cero (JOYSTICKID1) a 15.

pji

Puntero a una estructura JOYINFOEX que contiene información de posición extendida y estado del botón del joystick. Debe establecer los miembros dwSize y dwFlags o joyGetPosEx producirá un error. La información devuelta de joyGetPosEx depende de las marcas que especifique en dwFlags.

Valor devuelto

Devuelve JOYERR_NOERROR si se ejecuta correctamente o uno de los siguientes valores de error.

Código devuelto	Descripción
MMSYSERR_NODRIVER	El controlador del joystick no está presente.
MMSYSERR_INVALPARAM	Se pasó un parámetro no válido.
MMSYSERR_BADDEVICEID	El identificador de joystick especificado no es válido.
JOYERR_UNPLUGGED	El joystick especificado no está conectado al sistema.
JOYERR_PARMS	El identificador de joystick especificado no es válido.

Comentarios

Esta función proporciona acceso a dispositivos extendidos, como pedales de rudder, sombreros de punto de vista, dispositivos con un gran número de botones y sistemas de coordenadas que usan hasta seis ejes. En el caso de los dispositivos de joystick que usan tres ejes o menos y tienen menos de cuatro botones, use la función joyGetPos .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	joystickapi.h (incluye Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Joysticks

Funciones de joystick multimedia