> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCaptureScreenshot

> XtfCaptureScreenshot

# XtfCaptureScreenshot

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

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XtfCaptureScreenshot(
         LPCWSTR address,
         HBITMAP* phBitmap
)  
```

<a id="parametersSection" />

### 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 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.

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite ; sinon, retourne un code d'erreur HRESULT.

<a id="remarksSection" />

## 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é dans `phBitmap` 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)](/fr/tools/tools-console/commandlinetools/xbcapture).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfconsolecontrol.h

**Bibliothèque :** xtfconsolecontrol.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[XtfConsoleControl](/fr/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[Référence de l'API native XBOX Tools Framework](/fr/reference/tools/xtf/atoc-xtf-native)


## Related topics

- [XtfCaptureRecordedGameClip](/fr/reference/tools/xtf/xtfapi/functions/xtfcapturegameclip-xbox-microsoft-m.md)
- [XAppCaptureScreenshotStream](/fr/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureTakeScreenshot](/fr/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureScreenshotFile](/fr/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureOpenScreenshotStream](/fr/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)