Функция XInputGetState (xinput.h)
Извлекает текущее состояние указанного контроллера.
Синтаксис
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 |