XINPUT_GAMEPAD-Struktur (xinput.h)

  • Artikel

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

Weitere Informationen

XINPUT_STATE

XInput-Strukturen

XInputGetState