XtfCaptureScreenshot
Capture l’affichage actuel de l’écran de la console de développement spécifiée sous forme de bitmap.Syntaxe
Paramètres
addressType : 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 du bitmap de l’affichage d’écran capturé, en cas de réussite. Lorsque vous avez fini d’utiliser ce bitmap, appelez
DeleteObject pour libérer les ressources associées au HBITMAP.
Valeur de retour
Type : HRESULT RetourneS_OK en cas de réussite ; sinon, retourne un code d’erreur HRESULT.
Remarques
Cette fonction capture un bitmap de ce qui est actuellement affiché à l’écran de la console de développement spécifiée. Le bitmap inclut tout ce qui est actuellement affiché sur la sortie de la console, notamment les applications exclusives, les applications partagées, les applications ancrées, l’interface utilisateur du système comme l’accueil ou les fenêtres contextuelles de notification, etc. Le 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’affichage 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 le bitmap retourné dansphBitmap pour déterminer la résolution du bitmap obtenu. La résolution attendue du bitmap obtenu 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
XtfConsoleControlRéférence de l’API native XBOX Tools Framework