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

# XAppCaptureTakeScreenshot

> XAppCaptureTakeScreenshot

# XAppCaptureTakeScreenshot

Prend une capture d'écran.

## Syntaxe

```cpp theme={null}
HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  
```

### Paramètres

*requestingUser*   \_In\_\
Type : XUserHandle

Handle représentant l'utilisateur qui demande la capture d'écran.

*result*   \_Out\_\
Type : [XAppCaptureTakeScreenshotResult\*](/fr-CA/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)

Résultats de la capture d'écran retournés.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).\
\[!NOTE]
Cette fonction n'est pas prise en charge sur XBOX Game Streaming. Consultez la section Configuration requise ci-dessous pour savoir quelles plateformes la prennent en charge.\
\[!NOTE]
Les captures d'écran plus anciennes seront supprimées lorsque l'espace alloué sera plein afin de faire de la place pour les nouvelles captures d'écran. Utilisez [PLS](/fr-CA/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members) (stockage local persistant), le stockage connecté (p. ex. [XGameSave](/fr-CA/reference/system/xgamesave/xgamesave_members) ou [XGameSaveFiles](/fr-CA/reference/system/xgamesavefiles/xgamesavefiles_members)) ou un système de stockage semblable afin de conserver les captures d'écran pendant une période déterminée.</Note>

**XAppCaptureTakeScreenshot** prend une capture d'écran comme si l'utilisateur l'avait déclenchée. Une notification toast s'affiche et la capture d'écran du jeu est sauvegardée.
Si le jeu s'exécute en SDR, un seul fichier est généré. Si le jeu s'exécute en HDR, deux fichiers sont générés, l'un en format HDR et l'autre en format SDR.
Les captures d'écran peuvent être téléversées automatiquement sur XBOX Live selon les préférences de l'utilisateur. Une fois la capture d'écran effectuée avec succès, le fichier obtenu peut être lu en ouvrant le flux de capture d'écran avec [XAppCaptureOpenScreenShotStream](/fr-CA/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) et en lisant la capture d'écran avec [XAppCaptureReadScreenshotStream](/fr-CA/reference/system/xappcapture/functions/xappcapturereadscreenshotstream). Ces deux fonctions exigent que vous utilisiez l'ID local retourné dans la structure [XAppCaptureTakeScreenshotResult](/fr-CA/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) retournée par cette fonction.

```cpp theme={null}
XAppCaptureTakeScreenshotResult takeScreenshotResult = {0};
XUserHandle user = nullptr;
/* See XUserAddAsync, XUserAddResult on how to initialize XUserHandle */
bool hasHDR = false;

LOG_IF_FAILED(XAppCaptureTakeScreenshot(user, &takeScreenshotResult));

hasHDR = static_cast<bool>(takeScreenshotResult.availableScreenshotFormats & XAppCaptureScreenshotFormatFlag::HDR);

appLog.AddLog("LocalId %s (%s)\n", takeScreenshotResult.localId, hasHDR ? "SDR & HDR" : "SDR only");
```

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Vue d'ensemble de GameDVR](/fr-CA/build/console-features/game-dvr/gamedvr-broadcast)\
[Membres de XAppCapture](/fr-CA/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureOpenScreenShotStream](/fr-CA/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)\
[XAppCaptureReadScreenShotStream](/fr-CA/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)\
[XAppCaptureCloseScreenshotStream](/fr-CA/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream)\
[XAppCaptureTakeScreenshotResult](/fr-CA/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)


## Related topics

- [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)