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

# XtfCreateConsoleControlClient

> XtfCreateConsoleControlClient

# XtfCreateConsoleControlClient

Inicializa una nueva instancia de la interfaz [IXtfConsoleControlClient](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) con la dirección especificada.

## Sintaxis

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

### Parámetros

*pszAddress*\
Tipo: LPCWSTR

Puntero a la dirección IP de herramientas de la consola de desarrollo que se va a usar para la nueva instancia de [IXtfConsoleControlClient](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md).

*riid*\
Tipo: REFIID

Puntero que recibe el identificador de instancia de la instancia de [IXtfConsoleControlClient](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) recién creada.

*ppvObject*\
Tipo: void\*\*

Puntero que recibe una referencia a la instancia de [IXtfConsoleControlClient](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) recién creada.

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

## Comentarios

Esta función crea y asocia una nueva instancia de [IXtfConsoleControlClient](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) a la consola especificada en `pszAddress`. A continuación, puede usar la nueva instancia de `IXtfConsoleControlClient` para recuperar información de la consola, como las opciones de configuración, la hora del sistema o los procesos que se están ejecutando actualmente. También puede establecer valores de configuración, generar volcados de pila o apagar la consola.

Para obtener más información sobre las API de herramientas y automatización disponibles, como XBOX Tools Framework (XTF), consulte [API de herramientas y automatización (tema con NDA)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env).

## Requisitos

**Encabezado:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

**Plataformas compatibles:** Windows (para las herramientas de consola XBOX)

## Consulte también

[XtfConsoleControl](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[XBOX Tools Framework](https://docs.xbox.com/es/reference/tools/xtf/atoc-xbox-tools-framework.md)


## Related topics

- [XtfConsoleControl (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [IXtfConsoleControlClient (Contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [ShutdownConsole](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_shutdownconsole.md)
- [GetRunningProcesses](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [SetConfigValue](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)