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