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

# XGameStreamingGetLastFrameDisplayed

> XGameStreamingGetLastFrameDisplayed

# XGameStreamingGetLastFrameDisplayed

<Info>**Déconseillé.** Cette API est déconseillée depuis la version 2604 du GDK et sera supprimée dans une version future du GDK. Il n'existe aucune API de remplacement : les titres doivent plutôt utiliser [XGameStreamingGetStreamAddedLatency](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency) pour les ajustements du jeu tenant compte de la latence.</Info>

Obtient le jeton de pipeline d'images de l'image la plus récemment affichée à l'écran du client de diffusion en continu.

## Syntaxe

```cpp theme={null}
HRESULT XGameStreamingGetLastFrameDisplayed(  
         XGameStreamingClientId client,  
         D3D12XBOX_FRAME_PIPELINE_TOKEN* framePipelineToken  
)  
```

### Paramètres

*client*   \_In\_\
Type : XGameStreamingClientId

ID de l'appareil client de diffusion en continu interrogé.

*framePipelineToken*   \_Out\_\
Type : D3D12XBOX\_FRAME\_PIPELINE\_TOKEN\*

Jeton de pipeline d'images de la dernière image affichée sur l'appareil client.

### Valeur de retour

Type : HRESULT

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur.

#### Erreurs potentielles

| Code d'erreur | Valeur d'erreur | Cause de l'erreur |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | Le runtime XGameStreaming n'a pas été initialisé. Appelez [XGameStreamingInitialize](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminginitialize) avant d'appeler d'autres API. |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | Le client spécifié n'est pas connecté. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Les données demandées ne sont pas disponibles. Elles pourraient l'être plus tard. |

## Remarques

Lorsqu'un joueur diffuse un jeu en continu, `XGameStreamingGetLastFrameDisplayed` peut être utilisée si le jeu doit modifier son comportement après avoir confirmé qu'une image donnée a été affichée à l'écran de l'utilisateur.

Voici quelques exemples de situations où un jeu peut l'utiliser :

* Un minuteur visuel a expiré et le joueur n'a effectué aucune action avant l'expiration.
* Une action n'a pas été effectuée dans la fenêtre appropriée.
* Un joueur a poursuivi son mouvement hors des limites et n'a rien fait pour se rattraper.

`XGameStreamingGetLastFrameDisplayed` doit être utilisée pour déterminer à quel moment une action aurait dû être effectuée, mais ne l'a pas été. Si le jeu doit déterminer ce qui était affiché lorsqu'une entrée **a été** effectuée par le joueur, il doit utiliser [XGameStreamingGetAssociatedFrame](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe).

## Exemple

```C++ theme={null}
// In this example, when processing input, the game would like to pass along the last frame 
// that was being displayed to the player so that their simulation engine can take that into account.
 

// The framePipelineToken was initially captured at the callback of WaitFrameEventX

void Game::Update(DX::StepTimer const& timer)
{
    ...

    D3D12XBOX_FRAME_PIPELINE_TOKEN framePipelineToken = D3D12XBOX_FRAME_PIPELINE_TOKEN_NULL;
    if SUCCEEDED(XGameStreamingGetLastFrameDisplayed(clientId, &framePipelineToken)
    {
        SimulateBasedOnLastFrameDisplayed(framePipelineToken);
    }
    else 
    {
        // don't have last token, potentially simulate based on current frame

        SimulateBasedOnCurrentFrame();
    }

    
      
    ...
}

```

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Présentation approfondie de la compensation de latence pour la diffusion de jeux en continu](/fr-CA/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)

## Voir aussi

[XGameStreamingGetAssociatedFrame](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe)\
[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members#Latency)\
[Vue d'ensemble de la compensation de latence pour la diffusion de jeux en continu](/fr-CA/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)


## Related topics

- [XGameStreamingGetLastFrameDisplayed](/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md)
- [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)