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

# XtfCreateConsoleControlClient

> XtfCreateConsoleControlClient

# XtfCreateConsoleControlClient

Initialise une nouvelle instance de l'interface [IXtfConsoleControlClient](/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) avec l'adresse spécifiée.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XtfCreateConsoleControlClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

<a id="parametersSection" />

### Paramètres

*pszAddress*\
Type : LPCWSTR

Pointeur vers l'adresse IP des outils de la console de développement à utiliser pour la nouvelle instance de [IXtfConsoleControlClient](/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient).

*riid*\
Type : REFIID

Pointeur qui reçoit l'identificateur d'instance de la nouvelle instance de [IXtfConsoleControlClient](/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) créée.

*ppvObject*\
Type : void\*\*

Pointeur qui reçoit une référence à la nouvelle instance de [IXtfConsoleControlClient](/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) créée.

<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 crée une nouvelle instance de [IXtfConsoleControlClient](/fr/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) et l'attache à la console spécifiée dans `pszAddress`. Vous pouvez ensuite utiliser la nouvelle instance de `IXtfConsoleControlClient` pour récupérer des informations de la console, comme les paramètres de configuration, l'heure système ou les processus en cours d'exécution. Vous pouvez également définir des valeurs de configuration, générer des vidages de pile ou arrêter la console.

Pour plus d'informations sur les API d'outils et d'automatisation disponibles, telles que XBOX Tools Framework (XTF), consultez [API d'outils et d'automatisation (rubrique sous NDA)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env).

<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)\
[XBOX Tools Framework](/fr/reference/tools/xtf/atoc-xbox-tools-framework)


## Related topics

- [XtfCreateConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md)
- [IXtfConsoleControlClient::GenerateStackDump](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_generatestackdump.md)
- [IXtfConsoleControlClient::GetRunningProcesses](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)