> ## 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 d'image 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 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.

<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 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)](/fr-CA/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-CA/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[Référence de l'API native XBOX Tools Framework](/fr-CA/reference/tools/xtf/atoc-xtf-native)


## Related topics

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