> ## 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/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)

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

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Il n'est pas sûr d'appeler cette fonction sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](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 les plus anciennes sont supprimées lorsque l'espace alloué est rempli, afin de faire de la place aux nouvelles captures d'écran. Utilisez [PLS](/fr/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members) (Persistent Local Storage), le stockage connecté (par exemple [XGameSave](/fr/reference/system/xgamesave/xgamesave_members) ou [XGameSaveFiles](/fr/reference/system/xgamesavefiles/xgamesavefiles_members)) ou un système de stockage similaire afin de conserver les captures d'écran pendant une période définie.</Note>

**XAppCaptureTakeScreenshot** prend une capture d'écran comme si l'utilisateur l'avait déclenchée. Une notification s'affiche et la capture d'écran du jeu est enregistré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 au format HDR et l'autre au format SDR.
Les captures d'écran peuvent être chargées automatiquement sur XBOX Live selon les préférences de l'utilisateur. Une fois la capture d'écran prise avec succès, le fichier obtenu peut être lu en ouvrant le flux de capture d'écran avec [XAppCaptureOpenScreenShotStream](/fr/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) et en lisant la capture d'écran avec [XAppCaptureReadScreenshotStream](/fr/reference/system/xappcapture/functions/xappcapturereadscreenshotstream). Ces deux fonctions nécessitent l'utilisation de l'ID local renvoyé dans la structure [XAppCaptureTakeScreenshotResult](/fr/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) renvoyé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 à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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


## Related topics

- [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureScreenshotStream](/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureOpenScreenshotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)