XINPUT_CAPABILITIES-Struktur (xinput.h)

Beschreibt die Funktionen eines verbundenen Controllers. Die XInputGetCapabilities-Funktion gibt XINPUT_CAPABILITIES zurück.

Syntax

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

Member

Type

Controllertyp. Er muss einen der folgenden Werte aufweisen.

Wert	BESCHREIBUNG
XINPUT_DEVTYPE_GAMEPAD	Das Gerät ist ein Gamecontroller.

SubType

Untertyp des Spielcontrollers. Eine Liste der zulässigen Untertypen finden Sie unter XINPUT und Controller-Untertypen .

Hinweis Einschränkungen für die Verwendung dieses Untertypwerts finden Sie unter Hinweise. In Zukunft können weitere Untertypen hinzugefügt werden.

 

Flags

Features des Controllers.

Wert	BESCHREIBUNG
XINPUT_CAPS_VOICE_SUPPORTED	Das Gerät verfügt über ein integriertes Sprachgerät.
XINPUT_CAPS_FFB_SUPPORTED	Das Gerät unterstützt die Funktion "Feedback erzwingen". Beachten Sie, dass diese Force-Feedback-Features über Rumble hinaus derzeit nicht über XINPUT unter Windows unterstützt werden.
XINPUT_CAPS_WIRELESS	Das Gerät ist drahtlos.
XINPUT_CAPS_PMD_SUPPORTED	Das Gerät unterstützt Plug-In-Module. Beachten Sie, dass Plug-In-Module wie das Texteingabegerät (TID) derzeit nicht über XINPUT unter Windows unterstützt werden.
XINPUT_CAPS_NO_NAVIGATION	Das Gerät verfügt über keine Menünavigationsschaltflächen (START, ZURÜCK, DPAD).

Gamepad

XINPUT_GAMEPAD Struktur, die verfügbare Controllerfeatures und Steuerungsauflösungen beschreibt.

Vibration

XINPUT_VIBRATION Struktur, die verfügbare Schwingungsfunktionen und Auflösungen beschreibt.

Hinweise

XInputGetCapabilities gibt XINPUT_CAPABILITIES zurück, um die Merkmale und die verfügbare Funktionalität eines angegebenen Controllers anzugeben.

XInputGetCapabilities legt die Strukturmember fest, um anzugeben, welche Eingaben das Gerät unterstützt. Bei Binärzustandssteuerelementen, z. B. digitalen Schaltflächen, gibt das entsprechende Bit an, ob das Steuerelement vom Gerät unterstützt wird oder nicht. Bei proportionalen Steuerelementen, z. B. Thumbsticks, gibt der Wert die Auflösung für dieses Steuerelement an. Einige der am wenigsten wichtigen Bits werden möglicherweise nicht festgelegt, was darauf hinweist, dass das Steuerelement keine Auflösung auf dieser Ebene bereitstellt.

Das SubType-Element gibt den spezifischen Untertyp des vorhandenen Controllers an. Spiele können den Controller-Untertyp erkennen und ihre Verarbeitung von Controllereingaben oder -ausgaben basierend auf Untertypen optimieren, die gut für ihr Spielgenre geeignet sind. Beispielsweise kann ein Autorennenspiel überprüfen, ob ein Radcontroller vorhanden ist, um eine genauere Kontrolle des zu fahrenden Fahrzeugs zu ermöglichen. Titel dürfen ein Gerät jedoch nicht basierend auf seinem Untertyp deaktivieren oder ignorieren. Untertypen, die nicht vom Spiel erkannt werden oder für die das Spiel nicht speziell abgestimmt ist, sollten als Standardcontroller (XINPUT_DEVSUBTYPE_GAMEPAD) behandelt werden.

Ältere XUSB-Windows-Treiber melden unvollständige Funktioneninformationen, insbesondere für drahtlose Geräte. Der neueste XUSB-Windows-Treiber bietet vollständige Unterstützung für kabelgebundene und drahtlose Geräte sowie vollständigere und genauere Funktionsflags.

Anforderungen

Anforderung	Wert
Header	xinput.h

Weitere Informationen

XINPUT_GAMEPAD

XINPUT_VIBRATION

XInput-Strukturen

XInputGetCapabilities