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

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

Синтаксис

void XInputEnable(
  [in] BOOL enable
);

Параметры

[in] enable

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

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

Никакой

Замечания

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

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

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

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

требования к платформе

Windows 8 (XInput 1.4), пакет SDK DirectX (XInput 1.3)

Требования

Требование Ценность
целевая платформа Виндоус
заголовка xinput.h
библиотеки Xinput.lib
DLL Xinput1_4.dll

См. также

XINPUT_GAMEPAD

XINPUT_STATE

функции XInput

XInputGetState

XInputSetState