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

# GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

Provoque l'énumération de tous les processus en cours d'exécution, en appelant un rappel pour chaque processus en cours d'exécution.

## Syntaxe

```cpp theme={null}
HRESULT GetRunningProcesses(
         IXtfRunningProcessCallback *pCallback
)  
```

### Paramètres

*pCallback*\
Type : IXtfRunningProcessCallback\*

Pointeur vers l'interface [IXtfRunningProcessCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md), appelée lorsqu'un processus en cours d'exécution est découvert.

### Valeur de retour

Type : HRESULT

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

## Remarques

Cette fonction amène l'API XBOX Tools Framework (XTF) à énumérer tous les processus en cours d'exécution sur la console de développement actuelle. Lorsqu'un processus en cours d'exécution est trouvé, l'API XTF appelle la fonction de rappel [OnFoundProcess](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) de l'interface [IXtfRunningProcessCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md) implémentée dans votre application et spécifiée dans `pCallback`. L'API XTF transmet un pointeur vers une structure [XTFPROCESSINFO](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md), qui décrit le processus en cours d'exécution, lorsqu'elle appelle votre fonction `OnFoundProcess` implémentée.

\[!NOTE] La mémoire de la structure [XTFPROCESSINFO](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) appartient à l'API XBOX Tools Framework (XTF) et est invalidée après chaque appel de votre fonction de rappel [IXtfRunningProcessCallback::OnFoundProcess](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md). Vous devez copier les informations de la structure si vous en avez besoin ultérieurement.

> [!NOTE]
>
> Pour obtenir la liste des processus en cours d'exécution dans la partition du titre, vous devez ajouter `/title` à l'adresse indiquée dans [XtfCreateConsoleClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md) lors de la création de l'instance [IXtfConsoleControlClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) ; sinon, cette fonction retourne la liste des processus en cours d'exécution dans la partition système.

Pour plus d'informations sur l'affichage de la liste des processus en cours d'exécution à l'aide de XBOX Tools Framework (XTF), consultez [Liste des processus (xbtlist.exe) (rubrique sous NDA)](https://docs.xbox.com/fr/tools/tools-console/commandlinetools/xbtlist.md).

## Configuration requise

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

**Bibliothèque :** xtfconsolecontrol.lib

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

## Voir aussi

[IXtfConsoleControlClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [IXtfRunningProcessCallback (contenu de l'interface)](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl (contenu de l'API)](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (contenu de l'interface)](https://docs.xbox.com/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
