XInputSetState-Funktion (xinput.h)

Sendet Daten an einen verbundenen Controller. Diese Funktion wird verwendet, um die Vibrationsfunktion eines Controllers zu aktivieren.

Syntax

DWORD XInputSetState(
  [in]      DWORD            dwUserIndex,
  [in, out] XINPUT_VIBRATION *pVibration
);

Parameter

[in] dwUserIndex

Index des Controller des Benutzers. Kann ein Wert von 0 bis 3 sein. Informationen dazu, wie dieser Wert bestimmt wird und wie der Wert Indikatoren auf dem Controller zugeordnet wird, finden Sie unter Mehrere Controller.

[in, out] pVibration

Zeiger auf eine XINPUT_VIBRATION Struktur, die die Schwingungsinformationen enthält, die an den Controller gesendet werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn der Controller nicht verbunden ist, wird der Rückgabewert ERROR_DEVICE_NOT_CONNECTED.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in WinError.h definierter Fehlercode. Die Funktion verwendet SetLastError nicht, um den Letzten Fehlercode des aufrufenden Threads festzulegen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile xinput.h
Bibliothek Xinput.lib; Xinput9_1_0.lib
DLL Xinput1_4.dll; Xinput9_1_0.dll

Weitere Informationen

XINPUT_VIBRATION

XInput-Funktionen

XInputGetState