JOYINFOEX-Struktur (joystickapi.h)

  • Artikel

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

joyGetPosEx