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

# XAppCaptureTakeDiagnosticScreenshot

> XAppCaptureTakeDiagnosticScreenshot

# XAppCaptureTakeDiagnosticScreenshot

Prend une capture d'écran de diagnostic à partir de votre application.

## Syntaxe

```cpp theme={null}
HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  
```

### Paramètres

*gamescreenOnly*   \_In\_\
Type : bool

Détermine si seul l'écran de jeu est capturé. Si la valeur est false, il est possible que certains éléments d'interface utilisateur, comme un clavier visuel, soient capturés en plus de l'écran de jeu.

*captureFlags*   \_In\_\
Type : [XAppCaptureScreenshotFormatFlag](/fr/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)

Détermine si la capture sera une capture SDR ou HDR.

*filenamePrefix*   \_In\_opt\_\
Type : char\*

Préfixe souhaité pour le nom de fichier, facultatif ; il sera ajouté au début du nom du fichier de diagnostic.

*result*   \_Out\_\
Type : [XAppCaptureDiagnosticScreenshotResult\*](/fr/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)

La capture d'écran obtenue.

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

Contrairement à [XAppCaptureTakeScreenshot](/fr/reference/system/xappcapture/functions/xappcapturetakescreenshot), l'appel de cette fonction ne déclenche pas de notification d'interface utilisateur. **XAppCaptureTakeDiagnosticScreenshot** utilise [XAppCaptureScreenshotFormatFlag](/fr/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) pour indiquer si la capture d'écran sera en SDR, en HDR ou dans les deux formats. Toutefois, vous devez tout de même être en mode HDR pour effectuer une capture HDR. Les captures d'écran sont enregistrées dans une partition accessible par le jeu. La structure [XAppCaptureDiagnosticScreenshotResult](/fr/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) contient un tableau de [XAppCaptureScreenshotFile](/fr/reference/system/xappcapture/structs/xappcapturescreenshotfile) ; chaque structure contient un chemin de fichier vers la capture d'écran.

Cette fonction n'est disponible que sur les kits de développement. Sur les kits commerciaux, cette API renvoie immédiatement une erreur.

## 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)\
[XAppCaptureDiagnosticScreenshotResult](/fr/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/fr/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/fr/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/fr/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

- [XAppCaptureTakeDiagnosticScreenshot](/zh-CN/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)