Función XInputGetCapabilities (xinput.h)

  • Artículo

Recupera las funcionalidades y características de un controlador conectado.

Sintaxis

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

Parámetros

[in] dwUserIndex

Índice del controlador del usuario. Puede ser un valor en el intervalo entre 0 y 3. Para obtener información sobre cómo se determina este valor y cómo se asigna el valor a los indicadores en el controlador, vea Varios controladores.

[in] dwFlags

Marcas de entrada que identifican el tipo de controlador. Si este valor es 0, se devuelven las funcionalidades de todos los controladores conectados al sistema. Actualmente, solo se admite un valor:

Valor Descripción
XINPUT_FLAG_GAMEPAD Limite la consulta a los dispositivos de tipo controlador.
 

Cualquier valor de dwflags que no sea el anterior o 0 no es válido y provocará una interrupción de error al depurar.

[out] pCapabilities

Puntero a una estructura de XINPUT_CAPABILITIES que recibe las funcionalidades del controlador.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si el controlador no está conectado, el valor devuelto se ERROR_DEVICE_NOT_CONNECTED.

Si se produce un error en la función, el valor devuelto es un código de error definido en WinError.h. La función no usa SetLastError para establecer el código de último error del subproceso que realiza la llamada.

Comentarios

Nota La versión heredada de XINPUT 9.1.0 (incluida en Windows Vista y versiones posteriores) siempre devolvió un conjunto fijo de funcionalidades independientemente del dispositivo conectado.
 

Requisitos de la plataforma

Windows 8 (XInput 1.4), Sdk de DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)

Requisitos

   
Plataforma de destino Windows
Encabezado xinput.h
Library Xinput.lib; Xinput9_1_0.lib
Archivo DLL Xinput1_4.dll; Xinput9_1_0.dll

Consulte también

Funciones XInput

XInputGetState

XInputSetState