> ## 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 du jeu sera capturé. Si la valeur est false, il est possible que certains éléments d'interface utilisateur, comme un clavier à l'écran, soient capturés en plus de l'écran du jeu.

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

Détermine si la capture sera en SDR ou en 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-CA/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é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>

Contrairement à [XAppCaptureTakeScreenshot](/fr-CA/reference/system/xappcapture/functions/xappcapturetakescreenshot), l'appel de cette fonction ne déclenche pas de notification d'interface utilisateur. **XAppCaptureTakeDiagnosticScreenshot** utilise [XAppCaptureScreenshotFormatFlag](/fr-CA/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) pour indiquer si la capture d'écran sera en SDR, en HDR ou dans les deux formats. Cependant, vous devez tout de même exécuter en HDR pour effectuer une capture HDR. Les captures d'écran sont enregistrées dans une partition accessible au jeu. La structure [XAppCaptureDiagnosticScreenshotResult](/fr-CA/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) contient un tableau de [XAppCaptureScreenshotFile](/fr-CA/reference/system/xappcapture/structs/xappcapturescreenshotfile), et 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 consoles commerciales, cette API retourne 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 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)\
[XAppCaptureDiagnosticScreenshotResult](/fr-CA/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/fr-CA/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/fr-CA/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/fr-CA/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

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