JOYINFOEX-Struktur (joystickapi.h)
Die JOYINFOEX-Struktur enthält erweiterte Informationen über die Joystickposition, die Ansichtsposition und den Tastenstatus.
Syntax
typedef struct joyinfoex_tag {
DWORD dwSize;
DWORD dwFlags;
DWORD dwXpos;
DWORD dwYpos;
DWORD dwZpos;
DWORD dwRpos;
DWORD dwUpos;
DWORD dwVpos;
DWORD dwButtons;
DWORD dwButtonNumber;
DWORD dwPOV;
DWORD dwReserved1;
DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;
Members
dwSize
Größe dieser Struktur in Bytes.
dwFlags
Flags, die die gültigen Informationen angibt, die in dieser Struktur zurückgegeben werden. Elemente, die keine gültigen Informationen enthalten, werden auf 0 festgelegt. Die folgenden Flags werden definiert:
| Flag | Beschreibung |
|---|---|
| JOY_RETURNALL | Entspricht dem Festlegen aller JOY_RETURN Bits außer JOY_RETURNRAWDATA. |
| JOY_RETURNBUTTONS | Das dwButtons-Element enthält gültige Informationen über den Zustand der einzelnen Joysticktasten. |
| JOY_RETURNCENTERED | Zentrieren Sie die neutrale Position des Joysticks auf den Mittleren Wert jeder Bewegungsachse. |
| JOY_RETURNPOV | Das dwPOV-Element enthält gültige Informationen zum Point-of-View-Steuerelement, ausgedrückt in diskreten Einheiten. |
| JOY_RETURNPOVCTS | Das dwPOV-Element enthält gültige Informationen über das Point-of-View-Steuerelement, das in kontinuierlichen Einheiten mit hundertstel Grad ausgedrückt wird. |
| JOY_RETURNR | Das dwRpos-Element enthält gültige Ruderpedaldaten. Diese Informationen stellen eine weitere (vierte) Achse dar. |
| JOY_RETURNRAWDATA | In dieser Struktur gespeicherte Daten sind nicht kalibrierte Joystick-Messwerte. |
| JOY_RETURNU | Das dwUpos-Element enthält gültige Daten für eine fünfte Achse des Joysticks, wenn eine solche Achse verfügbar ist, oder gibt andernfalls null zurück. |
| JOY_RETURNV | Das dwVpos-Element enthält gültige Daten für eine sechste Achse des Joysticks, wenn eine solche Achse verfügbar ist, oder gibt andernfalls null zurück. |
| JOY_RETURNX | Das dwXpos-Element enthält gültige Daten für die x-Koordinate des Joysticks. |
| JOY_RETURNY | Das dwYpos-Element enthält gültige Daten für die y-Koordinate des Joysticks. |
| JOY_RETURNZ | Das dwZpos-Element enthält gültige Daten für die Z-Koordinate des Joysticks. |
Die folgenden Flags enthalten Daten zum Kalibrieren eines Joysticks und sind für benutzerdefinierte Kalibrierungsanwendungen vorgesehen.
| Flag | Beschreibung |
|---|---|
| JOY_CAL_READ3 | Lesen Sie die x-, y- und z-Koordinaten, und speichern Sie die Rohwerte in dwXpos, dwYpos und dwZpos. |
| JOY_CAL_READ4 | Lesen Sie die Ruderinformationen und die x-, y- und z-Koordinaten, und speichern Sie die Rohwerte in dwXpos, dwYpos, dwZpos und dwRpos. |
| JOY_CAL_READ5 | Lesen Sie die Ruderinformationen und die x-, y-, z- und You-Koordinaten und speichern Sie die Rohwerte in dwXpos, dwYpos, dwZpos, dwRpos und dwUpos. |
| JOY_CAL_READ6 | Lesen Sie die unformatierten V-Achsendaten, wenn ein Joystick-Minitreiber vorhanden ist, der die Daten bereitstellt. Gibt andernfalls null zurück. |
| JOY_CAL_READALWAYS | Lesen Sie den Joystickport, auch wenn der Treiber kein Gerät erkennt. |
| JOY_CAL_READRONLY | Lesen Sie die Ruderinformationen, wenn ein Joystick-Minitreiber vorhanden ist, der die Daten bereitstellt und den Rohwert in dwRpos speichert. Gibt andernfalls null zurück. |
| JOY_CAL_READXONLY | Lesen Sie die x-Koordinate, und speichern Sie den unformatierten (nicht kalibrierten) Wert in dwXpos. |
| JOY_CAL_READXYONLY | Liest die x- und y-Koordinaten und platziert die Rohwerte in dwXpos und dwYpos. |
| JOY_CAL_READYONLY | Liest die y-Koordinate und speichert den Rohwert in dwYpos. |
| JOY_CAL_READZONLY | Lesen Sie die z-Koordinate, und speichern Sie den Rohwert in dwZpos. |
| JOY_CAL_READUONLY | Lesen Sie die u-Koordinate, wenn ein Joystick-Minitreiber vorhanden ist, der die Daten bereitstellt und den Rohwert in dwUpos speichert. Gibt andernfalls null zurück. |
| JOY_CAL_READVONLY | Lesen Sie die v-Koordinate, wenn ein Joystick-Minitreiber vorhanden ist, der die Daten bereitstellt und den Rohwert in dwVpos speichert. Gibt andernfalls null zurück. |
dwXpos
Aktuelle X-Koordinate.
dwYpos
Aktuelle Y-Koordinate.
dwZpos
Aktuelle Z-Koordinate.
dwRpos
Aktuelle Position des Ruders oder der vierten Joystickachse.
dwUpos
Aktuelle Position der fünften Achse.
dwVpos
Aktuelle position der sechsten Achse.
dwButtons
Aktueller Zustand der 32 Joysticktasten. Der Wert dieses Elements kann auf eine beliebige Kombination von JOY_BUTTON n-Flags festgelegt werden, wobei n ein Wert im Bereich von 1 bis 32 ist, der der schaltfläche entspricht, die gedrückt wird.
dwButtonNumber
Aktuelle Schaltflächennummer, die gedrückt wird.
dwPOV
Aktuelle Position des Point-of-View-Steuerelements. Die Werte für dieses Element liegen zwischen 0 und 35.900. Diese Werte stellen den Winkel jeder Ansicht multipliziert mit 100 in Grad dar.
dwReserved1
Reserviert; nicht verwenden.
dwReserved2
Reserviert; nicht verwenden.
Hinweise
Der Wert des dwSize-Members wird auch verwendet, um die Versionsnummer für die Struktur zu identifizieren, wenn sie an die joyGetPosEx-Funktion übergeben wird.
Die meisten Geräte mit einem Point-of-View-Steuerelement haben nur fünf Positionen. Wenn das JOY_RETURNPOV-Flag festgelegt ist, werden diese Positionen mithilfe der folgenden Konstanten gemeldet:
| Point-of-View-Flag | BESCHREIBUNG |
|---|---|
| JOY_POVBACKWARD | Point-of-View-Hut wird rückwärts gedrückt. Der Wert 18.000 stellt eine Ausrichtung von 180,00 Grad (nach hinten) dar. |
| JOY_POVCENTERED | Der Point-of-View-Hut befindet sich in der neutralen Position. Der Wert -1 bedeutet, dass der Point-of-View-Hut keinen zu meldenden Winkel aufweist. |
| JOY_POVFORWARD | Point-of-View-Hut wird vorwärts gedrückt. Der Wert 0 stellt eine Ausrichtung von 0,00 Grad (geradeaus) dar. |
| JOY_POVLEFT | Der Point-of-View-Hut wird nach links gedrückt. Der Wert 27.000 stellt eine Ausrichtung von 270,00 Grad (90,00 Grad links) dar. |
| JOY_POVRIGHT | Der Point-of-View-Hut wird nach rechts gedrückt. Der Wert 9.000 stellt eine Ausrichtung von 90,00 Grad (rechts) dar. |
Der Standard-Joysticktreiber unterstützt derzeit diese fünf diskreten Richtungen. Wenn eine Anwendung nur die definierten Point-of-View-Werte akzeptieren kann, muss sie das flag JOY_RETURNPOV verwenden. Wenn eine Anwendung andere Gradmessungen akzeptieren kann, sollte sie das flag JOY_RETURNPOVCTS verwenden, um fortlaufende Daten abzurufen, sofern diese verfügbar sind. Das JOY_RETURNPOVCTS-Flag unterstützt auch die JOY_POV Konstanten, die mit dem JOY_RETURNPOV-Flag verwendet werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | joystickapi.h (windows.h einschließen) |
Weitere Informationen
Joysticks
Multimedia-Joystick-Strukturen