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

Статья
08/28/2023

Извлекает текущее состояние указанного контроллера.

Синтаксис

DWORD XInputGetState(
  [in]  DWORD        dwUserIndex,
  [out] XINPUT_STATE *pState
);

Параметры

[in] dwUserIndex

Индекс контроллера пользователя. Может иметь значение от 0 до 3. Сведения о том, как определяется это значение и как оно сопоставляется с индикаторами на контроллере, см. в разделе Несколько контроллеров.

[out] pState

Указатель на структуру XINPUT_STATE , которая получает текущее состояние контроллера.

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

Если функция завершается успешно, возвращаемое значение будет ERROR_SUCCESS.

Если контроллер не подключен, возвращаемое значение будет ERROR_DEVICE_NOT_CONNECTED.

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, определенный в Winerror.h. Функция не использует SetLastError для задания кода последней ошибки вызывающего потока.

Если для получения данных контроллера используется XInputGetState , каждый из триггеров слева и справа отображается отдельно. По причинам прежних версий, когда DirectInput извлекает данные контроллера, два триггера используют одну и ту же ось. Устаревшее поведение заметно в текущем панель управления игрового устройства, который использует DirectInput для состояния контроллера.

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

Windows 8 (XInput 1.4), пакет SDK Для DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)

Требования

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