Skip to main content

XAppCaptureReadScreenshotStream

Lit un flux de capture d’écran.

Syntaxe

Paramètres

handle   _In_
Type : XAppCaptureScreenshotStreamHandle
Handle du flux de capture d’écran retourné par l’appel à XAppCaptureOpenScreenshotStream. startPosition   _In_
Type : uint64_t
Position dans le flux à partir de laquelle commencer la lecture. bytesToRead   _In_
Type : uint32_t
Nombre d’octets à lire dans le flux. buffer   _Out_writes_to_(bytesToRead,bytesWritten)
Type : uint8_t
Mémoire tampon destinée à contenir les octets lus par XAppCaptureReadScreenshotStream. bytesWritten   _Out_
Type : uint32_t*
Nombre d’octets réellement écrits dans buffer.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
Avant de lire une capture d’écran, vous devez ouvrir un flux de capture d’écran avec XAppCaptureOpenScreenShotStream. Cela produit le XAppCaptureScreenshotStreamHandle nécessaire pour le paramètre handle. Vous pouvez ensuite appeler cette fonction pour lire la capture d’écran. Les paramètres startPosition et bytesToRead vous permettent de lire une section de la capture d’écran, ce qui est utile pour lire un flux volumineux section par section. Vous pouvez obtenir la taille totale du flux à partir du paramètre de sortie totalBytes de XAppCaptureOpenScreenShotStream. Les paramètres de sortie buffer et bytesWritten vous aident à lire avec précision les données retournées par cette fonction. Après avoir lu les données de la capture d’écran, fermez le flux de capture d’écran 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
XAppCaptureOpenScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
Last modified on October 6, 2026