joyGetPosEx-Funktion (joystickapi.h)

  • Artikel

Die joyGetPosEx-Funktion fragt einen Joystick nach seiner Position und Schaltfläche status ab.

Syntax

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Parameter

uJoyID

Bezeichner des abzufragten Joysticks. Gültige Werte für uJoyID reichen von null (JOYSTICKID1) bis 15.

pji

Zeiger auf eine JOYINFOEX-Struktur, die erweiterte Positionsinformationen und Schaltflächen status des Joysticks enthält. Sie müssen die dwSize - und dwFlags-Member festlegen, oder joyGetPosEx schlägt fehl. Die von joyGetPosEx zurückgegebenen Informationen hängen von den Flags ab, die Sie in dwFlags angeben.

Rückgabewert

Gibt bei erfolgreicher Ausführung JOYERR_NOERROR oder einen der folgenden Fehlerwerte zurück.

Rückgabecode Beschreibung
MMSYSERR_NODRIVER
 Der Joysticktreiber ist nicht vorhanden.
MMSYSERR_INVALPARAM
 Es wurde ein ungültiger Parameter übergeben.
MMSYSERR_BADDEVICEID
 Der angegebene Joystickbezeichner ist ungültig.
JOYERR_UNPLUGGED
 Der angegebene Joystick ist nicht mit dem System verbunden.
JOYERR_PARMS
 Der angegebene Joystickbezeichner ist ungültig.

Hinweise

Diese Funktion bietet Zugriff auf erweiterte Geräte wie Ruderpedale, Point-of-View-Hüte, Geräte mit einer großen Anzahl von Tasten und Koordinatensysteme mit bis zu sechs Achsen. Verwenden Sie für Joystick-Geräte, die drei oder weniger Achsen verwenden und weniger als vier Tasten haben, die joyGetPos-Funktion .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile joystickapi.h (windows.h einschließen)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Joysticks

Multimedia-Joystick-Funktionen