> ## 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

Récupère l'état actuel de la manette spécifiée et l'associe à un jeton de pipeline de frame D3DX.

## Syntaxe

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

### Paramètres

*dwUserIndex*   \_In\_\
Type : DWORD

Index du joueur associé à l'appareil ; valeur comprise entre 0 et `XUSER_MAX_COUNT - 1`.

*framePipelineToken*   \_In\_\
Type : UINT64

Jeton de pipeline de frame D3DX.

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

Pointeur vers un objet [XINPUT\_STATE](https://docs.xbox.com/fr/reference/input/xinputongameinput/structs/xinput_state.md) qui reçoit l'état actuel de la manette.

### Valeur renvoyée

Type : DWORD

Si la fonction réussit, elle renvoie `ERROR_SUCCESS`.

Si la manette n'est pas connectée, la fonction renvoie `ERROR_DEVICE_NOT_CONNECTED`.

Si la fonction échoue, elle renvoie un code d'erreur défini dans WinError.h.

## Remarques

Cette fonction est similaire à [XInputGetState](https://docs.xbox.com/fr/reference/input/xinputongameinput/functions/xinputgetstate.md), mais elle associe une lecture d'entrée spécifique à une frame graphique pour une analyse ultérieure.

> [!NOTE]
>
> Depuis la version May Preview, le comportement de `XInputGetStateWithToken` est identique à celui de `XInputGetState`, car le code GameInput sous-jacent n'est pas entièrement implémenté.

En fournissant le jeton de pipeline de frame, vous pouvez ultérieurement mettre en corrélation les appels d'API d'entrée avec des frames graphiques spécifiques dans le logiciel PIX.

## Configuration requise

**En-tête :** XInputOnGameInput.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

- [XInputGetState](https://docs.xbox.com/fr/reference/input/xinputongameinput/functions/xinputgetstate.md)
- [XINPUT_STATE](https://docs.xbox.com/fr/reference/input/xinputongameinput/structs/xinput_state.md)
- [Portage de XInput vers GameInput](https://docs.xbox.com/fr/build/core-features/common/input/porting/input-porting-xinput.md)
- [XInputOnGameInput (contenu de l'API)](https://docs.xbox.com/fr/reference/input/xinputongameinput/xinputongameinput_members.md)
- [GetSensorsState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md)