> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XInputGetStateWithToken

> XInputGetStateWithToken

# XInputGetStateWithToken

Recupera el estado actual del mando especificado y lo asocia con un token de canalización de fotogramas D3DX.

## Sintaxis

```cpp theme={null}
DWORD XInputGetStateWithToken(  
         DWORD dwUserIndex,  
         UINT64 framePipelineToken,  
         XINPUT_STATE * pState  
)  
```

### Parámetros

*dwUserIndex*   \_In\_\
Tipo: DWORD

Índice del jugador asociado al dispositivo; un valor en el intervalo de 0 a `XUSER_MAX_COUNT - 1`.

*framePipelineToken*   \_In\_\
Tipo: UINT64

Token de canalización de fotogramas D3DX.

*pState*   \_Out\_\
Tipo: [XINPUT\_STATE](https://docs.xbox.com/es/reference/input/xinputongameinput/structs/xinput_state.md)\*

Puntero a un objeto [XINPUT\_STATE](https://docs.xbox.com/es/reference/input/xinputongameinput/structs/xinput_state.md) que recibe el estado actual del mando.

### Valor devuelto

Tipo: DWORD

Si la función se ejecuta correctamente, devuelve `ERROR_SUCCESS`.

Si el mando no está conectado, la función devuelve `ERROR_DEVICE_NOT_CONNECTED`.

Si la función da error, devuelve un código de error definido en WinError.h.

## Comentarios

Esta función es similar a [XInputGetState](https://docs.xbox.com/es/reference/input/xinputongameinput/functions/xinputgetstate.md), pero asocia una lectura de entrada específica con un fotograma gráfico para su posterior análisis.

> [!NOTE]
>
> A partir de la versión May Preview, el comportamiento de `XInputGetStateWithToken` es idéntico al de `XInputGetState`, porque el código subyacente de GameInput no está completamente implementado.

Al proporcionar el token de canalización de fotogramas, puede correlacionar más adelante las llamadas a la API de entrada con fotogramas gráficos específicos en el software PIX.

## Requisitos

**Encabezado:** XInputOnGameInput.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Portabilidad de XInput a GameInput](https://docs.xbox.com/es/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/es/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

- [XInputGetState](https://docs.xbox.com/es/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XINPUT_STATE](https://docs.xbox.com/es/reference/input/xinputongameinput/structs/xinput_state.md)
- [Portabilidad de XInput a GameInput](https://docs.xbox.com/es/build/core-features/common/input/porting/input-porting-xinput.md)
- [XInputOnGameInput (contenido de la API)](https://docs.xbox.com/es/reference/input/xinputongameinput/xinputongameinput_members.md)
- [GetGamepadState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)