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

# XtfCaptureOutputBegin

> XtfCaptureOutputBegin

# XtfCaptureOutputBegin

Démarre la capture de la sortie de débogage.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
void XtfCaptureOutputBegin(
         PCWSTR address,
         XtfDebugStringCallback debugStringCallback,
         XtfDebugStringErrorCallback debugStringErrorCallback,
         PVOID context,
         PHANDLE hListen
)  
```

<a id="parametersSection" />

### Paramètres

*address*\
Type : PCWSTR

\[in] Adresse IP de la console.

*debugStringCallback*\
Type : [XtfDebugStringCallback](/fr/reference/tools/xtf/xtfapi/functions/xtfdebugstringcallback-xtfapi-xbox-windows-m)

\[in, optional] Rappel facultatif invoqué pour chaque chaîne de débogage de sortie.

*debugStringErrorCallback*\
Type : [XtfDebugStringErrorCallback](/fr/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m)

\[in, optional] Rappel facultatif invoqué pour chaque erreur rencontrée.

*context*\
Type : PVOID

\[in, optional] Pointeur vers un objet passé aux fonctions de rappel. Cet objet permet d'associer chaque invocation de rappel à cette session de capture.

*hListen*\
Type : PHANDLE

\[out] Handle qui représente cette session de capture.

<a id="retvalSection" />

### Valeur renvoyée

Aucune.

<a id="remarksSection" />

## Remarques

Utilisez cette fonction et la fonction [XtfCaptureOutputEnd](/fr/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m) pour démarrer et arrêter la capture de la sortie de débogage générale d'une console de développement. Si vous souhaitez surveiller la sortie de débogage d'un ID de processus spécifique sur une console de développement, utilisez un client de moniteur de débogage. Pour plus d'informations sur l'utilisation d'un client de moniteur de débogage, consultez [XtfCreateDebugMonitorClient](/fr/reference/tools/xtf/xtfdebugmonitor/methods/xtfcreatedebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m).

Vous devez implémenter et spécifier une fonction `XtfDebugStringCallback` dans `debugStringCallback` si vous souhaitez capturer les chaînes de débogage d'une session de capture. De même, vous devez implémenter et spécifier une fonction `XtfDebugStringErrorCallback` dans `debugStringErrorCallback` pour capturer les erreurs rencontrées pendant une session de capture. Aucune de ces fonctions de rappel n'est toutefois obligatoire.

Pour arrêter la capture de la sortie de débogage et libérer les ressources associées à une session de capture, appelez [XtfCaptureOutputEnd](/fr/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m) en spécifiant le handle retourné dans `hListen` pour cette session de capture.

<Note>Vous devez appeler `XtfCaptureOutputEnd` pour arrêter une session de capture. Sinon, la session de capture devient orpheline et les ressources qui lui sont associées ne sont pas libérées, ce qui provoque une fuite de mémoire.</Note>

<a id="requirements" />

## Configuration requise

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

**Bibliothèque :** XtfApi.lib

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

<a id="seealsoSection" />

## Voir aussi

[Interface IXtfDebugMonitorClient](/fr/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-t)\
[Erreurs de transport XTF (rubrique sous NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfCaptureOutputBegin](/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputEnd](/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)