XInputEnable-Funktion (xinput.h)

Legt den Berichtsstatus von XInput fest.

Syntax

void XInputEnable(
  [in] BOOL enable
);

Parameter

[in] enable

Wenn die Option FALSE-ist, sendet XInput nur neutrale Daten als Reaktion auf XInputGetState- (alle Schaltflächen nach oben, Achsen zentriert und Trigger bei 0). XInputSetState Anrufe werden registriert, aber nicht an das Gerät gesendet. Das Senden eines anderen Werts als FALSE- stellt lese- und schreibfunktionen normal wieder her.

Rückgabewert

Nichts

Bemerkungen

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

In einem Controller, der Vibrationseffekte unterstützt:

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

Windows 10 oder höher:veraltete, da die Eingabe des Gamecontrollers vom System basierend auf dem Anwendungsfensterfokus automatisch aktiviert/deaktiviert wird.

Plattformanforderungen

Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3)

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- xinput.h
Library Xinput.lib
DLL- Xinput1_4.dll

Siehe auch

XINPUT_GAMEPAD

XINPUT_STATE

XInput-Funktionen

XInputGetState-

XInputSetState-