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

Статья
03/05/2024

Задает состояние отчета XInput.

Синтаксис

void XInputEnable(
  [in] BOOL enable
);

Параметры

[in] enable

Если параметр enable имеет значение FALSE, XInput будет отправлять нейтральные данные только в ответ на XInputGetState (все кнопки вверх, оси по центру и триггеры с 0). Вызовы XInputSetState будут зарегистрированы, но не отправлены на устройство. Отправка любого значения, отличного от FALSE , приведет к восстановлению функций чтения и записи в нормальное состояние.

Возвращаемое значение

None

Remarks

Эта функция предназначена для вызова, когда приложение получает или теряет фокус (например, через WM_ACTIVATEAPP). Используя эту функцию, вам не придется изменять цикл запроса XInput в приложении, так как нейтральные данные всегда будут отображаться, если XInput отключен.

В контроллере, поддерживающем вибрационные эффекты:

Передача false приведет к остановке любых вибрационных эффектов, которые в настоящее время воспроизводится. В этом состоянии вызовы XInputSetState будут зарегистрированы, но не переданы на устройство.
При передаче true последний запрос вибрации (даже если он равен 0), отправленный в XInputSetState на устройство.

Windows 10 или более поздней версии:не рекомендуется, так как вход игрового контроллера автоматически включается или отключается системой в зависимости от фокуса окна приложения.