Compartir a través de


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

Consulte también

XINPUT_GAMEPAD

XINPUT_STATE

Funciones XInput

XInputSetState