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 .
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 |