Función XInputGetState (xinput.h)
Recupera el estado actual del controlador especificado.
Sintaxis
DWORD XInputGetState(
[in] DWORD dwUserIndex,
[out] XINPUT_STATE *pState
);
Parámetros
[in] dwUserIndex
Índice del controlador del usuario. Puede ser un valor de 0 a 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.
[out] pState
Puntero a una estructura de XINPUT_STATE que recibe el estado actual del controlador.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se 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
Cuando se usa XInputGetState para recuperar los datos del controlador, los desencadenadores izquierdo y derecho se notifican por separado. Por motivos heredados, cuando DirectInput recupera los datos del controlador, los dos desencadenadores comparten el mismo eje. El comportamiento heredado es notable en el Panel de control actual del dispositivo de juego, que usa DirectInput para el estado del controlador.
Requisitos de la plataforma
Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | xinput.h |
| Library | Xinput.lib; Xinput9_1_0.lib |
| Archivo DLL | Xinput1_4.dll; Xinput9_1_0.dll; Xinputuap.dll |