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. Es muss sich um einen der folgenden Werte handeln.
| Wert | Beschreibung |
|---|---|
| XINPUT_DEVTYPE_GAMEPAD | Das Gerät ist ein Gamecontroller. |
SubType
Untertyp des Gamecontrollers. Weitere Informationen finden Sie unter XINPUT- und Controller-Untertypen für eine Liste zulässiger 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 Kraftrückmeldungsfunktionalität. Beachten Sie, dass diese Force-Feedback-Features über das 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 hat 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 die verfügbaren Vibrationsfunktionen 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 Strukturelemente fest, um anzugeben, welche Eingaben das Gerät unterstützt. Bei binären Zustandssteuerelementen, z. B. digitalen Schaltflächen, spiegelt das entsprechende Bit wider, ob das Steuerelement vom Gerät unterstützt wird. Bei proportionalen Steuerelementen, z. B. Daumensticks, gibt der Wert die Auflösung für dieses Steuerelement an. Einige der am wenigsten signifikanten Bits werden möglicherweise nicht festgelegt, was angibt, dass das Steuerelement keine Auflösung für diese Ebene bereitstellt.
Das SubType-Element gibt den spezifischen Untertyp des Controllers an, der vorhanden ist. Spiele können den Controller-Untertyp erkennen und deren Behandlung von Controllereingaben oder -ausgaben basierend auf Untertypen erkennen, die gut für ihr Spielgenre geeignet sind. Beispielsweise kann ein Autorennenspiel überprüfen, ob ein Radcontroller vorhanden ist, um eine feinere Kontrolle über das Auto zu ermöglichen, das gesteuert wird. Titel dürfen jedoch ein Gerät basierend auf seinem Untertyp nicht deaktivieren oder ignorieren. Untertypen, die vom Spiel nicht erkannt werden oder für die das Spiel nicht speziell abgestimmt ist, sollten als Standard Xbox 360 Controller (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ändige und präzisere Funktionen flags.
Anforderungen
| Header | xinput.h |