Skip to main content

XAppCaptureOpenScreenshotStream

Ouvre un flux de capture d’écran.

Syntaxe

Paramètres

localId   _In_
Type : char*
ID local de la capture d’écran retourné dans XAppCaptureTakeScreenshotResult après l’appel à XAppCaptureTakeScreenshot. screenshotFormat   _In_
Type : XAppCaptureScreenshotFormatFlag
Indicateur de format de capture d’écran retourné dans XAppCaptureTakeScreenshotResult après l’appel à XAppCaptureTakeScreenshot. handle   _Out_
Type : XAppCaptureScreenshotStreamHandle*
Handle du flux de capture d’écran retourné à la suite de l’ouverture du flux. totalBytes   _Out_opt_
Type : uint64_t*
Nombre total d’octets dans le flux.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à délai critique. Pour plus d’informations, consultez Threads à délai critique.
Les captures d’écran ne sont pas accessibles à partir de la partition du jeu; vous devez donc ouvrir un flux pour récupérer les captures d’écran prises par l’utilisateur ou avec XAppCaptureTakeScreenshot. XAppCaptureTakeScreenshot retourne dans son résultat un localID qui est utilisé dans cette fonction pour récupérer la bonne capture d’écran. Le localID reste valide tant que la capture d’écran est conservée sur le disque. L’espace de stockage des captures d’écran sur la console est limité. Les captures d’écran les plus anciennes sont supprimées lorsque l’espace alloué est plein. Cela pourrait faire en sorte que la fonction d’ouverture de capture d’écran ne trouve pas un localID. Après avoir ouvert le flux, vous pouvez lire la capture d’écran avec XAppCaptureReadScreenShotStream. Enfin, chaque flux doit être fermé avec XAppCaptureCloseScreenshotStream afin d’éviter une fuite de mémoire.

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
XAppCaptureReadScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Last modified on October 6, 2026