Passer au contenu principal

XtfCaptureScreenshot

Capture l’affichage actuel de l’écran de la console de développement spécifiée sous forme d’image bitmap.

Syntaxe

Paramètres

address   
Type : LPCWSTR
Pointeur vers l’adresse IP des outils ou le nom d’hôte de la console de développement. phBitmap   
Type : HBITMAP*
Pointeur vers le HBITMAP de l’image bitmap de l’affichage d’écran capturé, en cas de réussite. Lorsque vous avez fini d’utiliser cette image bitmap, appelez DeleteObject pour libérer les ressources associées au HBITMAP.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur HRESULT.

Remarques

Cette fonction capture une image bitmap de ce qui est actuellement affiché à l’écran de la console de développement spécifiée. L’image bitmap inclut tout ce qui est actuellement affiché sur la sortie de la console, y compris les applications exclusives, les applications partagées, les applications ancrées, l’interface utilisateur du système comme l’écran d’accueil ou les fenêtres contextuelles de notification, etc. L’image bitmap utilise la résolution d’affichage actuellement sélectionnée pour la console. L’utilisation de XtfCaptureScreenshot prend momentanément le contrôle du flux de sortie vidéo. Cela provoque un problème momentané de fréquence d’images à l’écran et peut entraîner un segment d’écran noir dans la vidéo enregistrée par GameDVR au moment de la capture. Votre code doit suivre les pratiques de programmation recommandées et utiliser les informations incorporées dans l’image bitmap retournée dans phBitmap pour déterminer la résolution de l’image bitmap obtenue. La résolution prévue de l’image bitmap obtenue correspond à la résolution d’écran actuelle de la console de développement. Pour plus d’informations sur la capture d’écran, consultez Outil de capture d’écran (xbcapture.exe) (rubrique sous NDA).

Configuration requise

En-tête : xtfconsolecontrol.h Bibliothèque : xtfconsolecontrol.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

XtfConsoleControl
Référence de l’API native XBOX Tools Framework
Dernière modification le 6 octobre 2026