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 renvoyés.

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.
[!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 les plus anciennes sont supprimées lorsque l’espace alloué est rempli, afin de faire de la place aux nouvelles captures d’écran. Utilisez PLS (Persistent Local Storage), le stockage connecté (par exemple XGameSave ou XGameSaveFiles) ou un système de stockage similaire afin de conserver les captures d’écran pendant une période définie.

XAppCaptureTakeScreenshot prend une capture d’écran comme si l’utilisateur l’avait déclenchée. Une notification s’affiche et la capture d’écran du jeu est enregistré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 au format HDR et l’autre au format SDR. Les captures d’écran peuvent être chargées automatiquement sur XBOX Live selon les préférences de l’utilisateur. Une fois la capture d’écran prise 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 nécessitent l’utilisation de l’ID local renvoyé dans la structure XAppCaptureTakeScreenshotResult renvoyé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