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

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

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.
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. 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 contient un tableau de 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

​
Voir aussi

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