Функция XInputSetState (xinput.h)

Статья
03/09/2024

Отправляет данные на подключенный контроллер. Эта функция используется для активации функции вибрации контроллера.

Синтаксис

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 для задания кода последней ошибки вызывающего потока.

Требования

Требование	Значение
Целевая платформа	Windows
Header	xinput.h
Библиотека	Xinput.lib; Xinput9_1_0.lib
DLL	Xinput1_4.dll; Xinput9_1_0.dll

См. также раздел

XINPUT_VIBRATION

Функции XInput

XInputGetState

Поделиться через