XINPUT_GAMEPAD-Struktur (xinput.h)
Beschreibt den aktuellen Zustand des Controllers.
Syntax
typedef struct _XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
Member
wButtons
Bitmaske der digitalen Schaltflächen des Geräts, wie folgt. Ein festgelegtes Bit gibt an, dass die entsprechende Schaltfläche gedrückt wird.
| Schaltfläche "Gerät" | Bitmaske |
|---|---|
| XINPUT_GAMEPAD_DPAD_UP | 0x0001 |
| XINPUT_GAMEPAD_DPAD_DOWN | 0x0002 |
| XINPUT_GAMEPAD_DPAD_LEFT | 0x0004 |
| XINPUT_GAMEPAD_DPAD_RIGHT | 0x0008 |
| XINPUT_GAMEPAD_START | 0x0010 |
| XINPUT_GAMEPAD_BACK | 0x0020 |
| XINPUT_GAMEPAD_LEFT_THUMB | 0x0040 |
| XINPUT_GAMEPAD_RIGHT_THUMB | 0x0080 |
| XINPUT_GAMEPAD_LEFT_SHOULDER | 0x0100 |
| XINPUT_GAMEPAD_RIGHT_SHOULDER | 0x0200 |
| XINPUT_GAMEPAD_A | 0x1000 |
| XINPUT_GAMEPAD_B | 0x2000 |
| XINPUT_GAMEPAD_X | 0x4000 |
| XINPUT_GAMEPAD_Y | 0x8000 |
Bits, die oben festgelegt, aber nicht definiert sind, sind reserviert, und ihr Zustand ist nicht definiert.
bLeftTrigger
Der aktuelle Wert des linken Trigger-Analogsteuerelements. Der Wert liegt zwischen 0 und 255.
bRightTrigger
Der aktuelle Wert des rechten Trigger-Analogsteuerelements. Der Wert liegt zwischen 0 und 255.
sThumbLX
Linker Daumenstick x-Achse- Wert. Jedes Der Ziehpunktachsenmember ist ein Vorzeichenwert zwischen -32768 und 32767, der die Position des Fingerabdrucksticks beschreibt. Der Wert 0 wird zentriert. Negative Werte bedeuten nach unten oder nach links. Positive Werte stehen für oben oder rechts. Die Konstanten XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE oder XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE können als positiver und negativer Wert verwendet werden, um eine Fingerstickeingabe zu filtern.
sThumbLY
Linker Y-Achse-Wert. Der Wert liegt zwischen -32768 und 32767.
sThumbRX
Rechter Daumenstick x-Achse Wert. Der Wert liegt zwischen -32768 und 32767.
sThumbRY
Wert der rechten Y-Achse. Der Wert liegt zwischen -32768 und 32767.
Hinweise
Diese Struktur wird von der XINPUT_STATE-Struktur verwendet, wenn Änderungen im Zustand des Controllers abgerufen werden.
Die spezifische Zuordnung von Schaltfläche zu Spielfunktion variiert je nach Spieltyp.
Die konstante XINPUT_GAMEPAD_TRIGGER_THRESHOLD kann als Wert verwendet werden, der bLeftTrigger und bRightTrigger größer als sein müssen, um als gedrückt registriert zu werden. Dies ist optional, aber oft wünschenswert. Controllerschaltflächen manifestieren keine Kreuzübersprechung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | xinput.h |