JoySetCapture

Aus API-Wiki
Wechseln zu: Navigation, Suche


Diese Funktion leitet die Nachrichten eines Joysticks an ein Fenster weiter.

<vb>Declare Function joySetCapture Lib "winmm.dll" ( _ ByVal hWnd As Long, _ ByVal uJoyID As Long, _ ByVal uPeriod As Long, _ ByVal fChanged As Long) As Long</vb>


Parameter

hWnd

Handle des Fensters, an das die Nachrichten weitergeleitet werden sollen

uJoyID

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

<vb>Const JOYSTICKID1 = 0 Const JOYSTICKID2 = 1</vb>

Unter neueren Systemen sind Werte von 0 bis 15 erlaubt.

uPeriod

Das Intervall zwischen zwei Nachrichten in Millisekunden

fChanged

Wenn für fChanged 1 übergeben wird, werden nur Nachrichten gesendet, wenn ein Knopf gedrückt wird oder der Joystick um mehr als die Bewegungsschwelle (die mit joyGetThreshold gelesen und mit joySetThreshold gesetzt werden kann) bewegt wird. Wird 0 für fChanged übergeben, werden die Nachrichten regelmäßig gesendet


Rückgabewert(e)

Die joySetCapture-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn kein Fehler aufgetreten ist. Mögliche andere Rückgabewerte sind:

<vb>Const MMSYSERR_BASE = 0 Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6) Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)

Const JOYERR_BASE = 160 Const JOYERR_PARMS = (JOYERR_BASE + 5) Const JOYERR_NOCANDO = (JOYERR_BASE + 6) Const JOYERR_UNPLUGGED = (JOYERR_BASE + 7)</vb>


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


Quellen

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