XAppCaptureTakeScreenshot

Syntaxe

HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  

Paramètres

requestingUser _In_
Type : XUserHandle

Handle représentant l’utilisateur qui demande la capture d’écran.

Résultats de la capture d’écran retournés.

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.
[!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 plus anciennes seront supprimées lorsque l’espace alloué sera plein afin de faire de la place pour les nouvelles captures d’écran. Utilisez PLS (stockage local persistant), le stockage connecté (p. ex. XGameSave ou XGameSaveFiles) ou un système de stockage semblable afin de conserver les captures d’écran pendant une période déterminée.

XAppCaptureTakeScreenshot prend une capture d’écran comme si l’utilisateur l’avait déclenchée. Une notification toast s’affiche et la capture d’écran du jeu est sauvegardé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 en format HDR et l’autre en format SDR. Les captures d’écran peuvent être téléversées automatiquement sur XBOX Live selon les préférences de l’utilisateur. Une fois la capture d’écran effectuée avec succès, le fichier obtenu peut être lu en ouvrant le flux de capture d’écran avec XAppCaptureOpenScreenShotStream et en lisant la capture d’écran avec XAppCaptureReadScreenshotStream. Ces deux fonctions exigent que vous utilisiez l’ID local retourné dans la structure XAppCaptureTakeScreenshotResult retournée par cette fonction.

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");

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XAppCaptureTakeScreenshot

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​XAppCaptureTakeScreenshot

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

XAppCaptureTakeScreenshot

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi