Skip to main content

​
XAppCaptureTakeDiagnosticScreenshot

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

​
Syntaxe

​
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 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* La capture d’écran obtenue.

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
Contrairement à XAppCaptureTakeScreenshot, l’appel de cette fonction ne déclenche pas de notification d’interface utilisateur. XAppCaptureTakeDiagnosticScreenshot utilise 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 contient un tableau de 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

​
Voir aussi

Vue d’ensemble de GameDVR
Membres de XAppCapture
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile
Last modified on October 6, 2026