XInputEnable-Funktion (xinput.h)

Artikel
03/13/2024

Legt den Berichterstellungsstatus von XInput fest.

Syntax

void XInputEnable(
  [in] BOOL enable
);

Parameter

[in] enable

Wenn enable FALSE ist, sendet XInput nur neutrale Daten als Reaktion auf XInputGetState (alle Schaltflächen nach oben, Achsen zentriert und Trigger auf 0). XInputSetState-Aufrufe werden registriert, aber nicht an das Gerät gesendet. Wenn Sie einen anderen Wert als FALSE senden, wird die Lese- und Schreibfunktion wieder normal verwendet.

Rückgabewert

Keine

Bemerkungen

Diese Funktion soll aufgerufen werden, wenn eine Anwendung den Fokus gewinnt oder verliert (z. B. über WM_ACTIVATEAPP). Mit dieser Funktion müssen Sie die XInput-Abfrageschleife in Ihrer Anwendung nicht ändern, da immer neutrale Daten gemeldet werden, wenn XInput deaktiviert ist.

In einem Controller, der Vibrationseffekte unterstützt:

Wenn FALSE übergeben wird, werden alle derzeit wiedergegebenen Vibrationseffekte beendet. In diesem Zustand werden Aufrufe von XInputSetState registriert, aber nicht an das Gerät übergeben.
Wenn TRUE übergeben wird, wird die letzte Vibrationsanforderung (auch wenn sie 0 ist) an XInputSetState an das Gerät übergeben.

Windows 10 oder höher:Veraltet, da die Eingabe des Spielcontrollers vom System basierend auf dem Fokus des Anwendungsfensters automatisch aktiviert/deaktiviert wird.