joySetCapture-Funktion (joystickapi.h)

  • Artikel

Die joySetCapture-Funktion erfasst einen Joystick, indem seine Nachrichten an das angegebene Fenster gesendet werden.

Syntax

MMRESULT joySetCapture(
  HWND hwnd,
  UINT uJoyID,
  UINT uPeriod,
  BOOL fChanged
);

Parameter

hwnd

Handle zum Fenster, um die Joysticknachrichten zu empfangen.

uJoyID

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

uPeriod

Abrufhäufigkeit in Millisekunden.

fChanged

Ändern des Positionsflags. Geben Sie TRUE für diesen Parameter an, um Nachrichten nur zu senden, wenn sich die Position um einen Wert ändert, der größer als der Schwellenwert für die Joystickbewegung ist. Andernfalls werden Nachrichten mit der in uPeriod angegebenen Abrufhäufigkeit gesendet.

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
 Ungültige Joystick-ID oder hwnd ist NULL.
JOYERR_NOCANDO
 Joystickeingaben können nicht erfasst werden, da ein erforderlicher Dienst (z. B. ein Windows-Timer) nicht verfügbar ist.
JOYERR_UNPLUGGED
 Der angegebene Joystick ist nicht mit dem System verbunden.
JOYERR_PARMS
 Ungültige Joystick-ID oder hwnd ist NULL.

Hinweise

Wenn der angegebene Joystick derzeit erfasst wird, gibt die Funktion ein undefiniertes Verhalten zurück. Rufen Sie die joyReleaseCapture-Funktion auf, um den erfassten Joystick freizugeben, oder zerstören Sie das Fenster, um den Joystick automatisch loszulassen.

Anforderungen

   
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