XInputSetState 函式 ()

將數據傳送至連接的控制器。此函式可用來啟動控制器的震動函式。

語法

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

[in] dwUserIndex

使用者控制器的索引。可以是從 0 到 3 的值。如需如何決定此值以及如何將值對應至控制器上指標的資訊，請參閱多個控制器。

[in, out] pVibration

包含要傳送至控制器之震動資訊的 XINPUT_VIBRATION 結構的指標。

如果函式成功，傳回值會 ERROR_SUCCESS。

如果控制器未連接，傳回值會 ERROR_DEVICE_NOT_CONNECTED。

如果函式失敗，傳回值是 WinError.h 中定義的錯誤碼。函式不會使用 SetLastError 來設定呼叫線程的最後一個錯誤碼。