Función XInputGetCapabilities (xinput.h)
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
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 |