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

Статья
10/28/2023

Извлекает возможности и функции подключенного контроллера.

Синтаксис

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

Параметры

[in] dwUserIndex

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

[in] dwFlags

Флаги ввода, определяющие тип контроллера. Если это значение равно 0, возвращаются возможности всех контроллеров, подключенных к системе. В настоящее время поддерживается только одно значение:

Значение	Описание
XINPUT_FLAG_GAMEPAD	Ограничьте запрос устройствами типа контроллера.

Любое значение dwflags, отличное от указанного выше или 0, является недопустимым и приведет к ошибке при отладке.

[out] pCapabilities

Указатель на структуру XINPUT_CAPABILITIES , которая получает возможности контроллера.

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

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

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

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

Примечание Устаревшая версия XINPUT 9.1.0 (включенная в Windows Vista и более поздних версий) всегда возвращала фиксированный набор возможностей независимо от подключенного устройства.

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

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

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

Функции XInput

XInputGetState

XInputSetState

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