JoyGetPosEx: Unterschied zwischen den Versionen

Version vom 10. Mai 2008, 20:50 Uhr

Diese Funktion fragt die Position eines Joysticks ab und gibt sie zurück. Es können außerdem weitere Werte abgefragt werden.

Declare Function joyGetPosEx Lib "winmm.dll" ( _
                             ByVal uJoyID As Long, _
                             ByRef pji As JOYINFOEX) As Long

Parameter

uJoyID [Übergabe]

Eine Nummer, die den abzufragenden Joystick bestimmt. Die folgenden Werte sind möglich:

Const JOYSTICKID1 = 0
Const JOYSTICKID2 = 1

pji [Übergabe]

Ein Zeiger auf eine JOYINFOEX-Struktur, die die ermittelten Werte erhält.

Rückgabewert(e)

Die joyGetPosEx-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn der Aufruf erfolgreich war. Mögliche andere Rückgabewerte sind:

Const MMSYSERR_BASE = 0
Const MMSYSERR_BADDEVICEID = (MMSYSERR_BASE + 2)
Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6)
Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)
Const JOYERR_BASE = 160
Const JOYERR_PARMS = (JOYERR_BASE + 5)
Const JOYERR_UNPLUGGED = (JOYERR_BASE + 7)

Sonstige Hinweise

Die Werte dwFlags und dwSize der JOYINFOEX-Struktur müssen zugewiesen werden, ansonsten wird joyGetPosEx versagen.
Die joyGetPosEx-Funktion lohnt nur für Joysticks mit mehr als drei Achsen und/oder mehr als vier Knöpfen. Wenn Informationen über 3 Achsen und 4 Knöpfe hinreichend sind, empfiehlt sich die joyGetPos-Funktion.

Beispiel

Dim JIE As JOYINFOEX

JIE.dwSize = Len(JIE)
JIE.dwFlags = JOY_RETURNALL

ret = joyGetPOS(JOYSTICKID1, JIE)

If ret <> JOYERR_NOERROR Then
   ' Fehler beim Aufruf
End If

Der Wert für JOY_RETURNALL ist bei JOYINFOEX unter dwFlags zu finden.

Verwandte Funktionen

• joyConfigChanged - Weist den Joystick-Treiber an, geänderte Informationen zu aktualisieren
  
• joyGetDevCaps - Fragt Informationen über den Joystick ab
  
• joyGetNumDevs - Gibt die Anzahl unterstützter Joysticks zurück
  
• joyGetPos - Fragt die Positionsdaten eines Joysticks ab
  
• joyGetPosEx - Fragt die Positionsdaten eines Joysticks ab
  
• joyGetThreshold - Gibt die Bewegunsschwelle zurück, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben
  
• joyReleaseCapture - Gibt ein Capture auf einen Joystick wieder frei
  
• joySetCapture - Setzt ein Capture auf einen Joystick, sodass Informationen per Fenster-Nachricht empfangen werden
  
• joySetThreshold - Setzt die Bewegungsschelle eines Joysticks, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben

Verweise

MSDN Library - joyGetPosEx

Quellen

MSDN Library - joyGetPosEx
freepascal.org - Reference for unit 'mmsystem': Constants