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

# IXtfConsoleControlClient::GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

Hace que se enumeren todos los procesos en ejecución e invoca una devolución de llamada para cada proceso en ejecución.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*pCallback*\
Tipo: IXtfRunningProcessCallback\*

Un puntero a la interfaz [IXtfRunningProcessCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback), que se invoca cuando se detecta un proceso en ejecución.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentarios

Esta función hace que la API de XBOX Tools Framework (XTF) enumere todos los procesos en ejecución en la consola de desarrollo actual. Cuando se encuentra un proceso en ejecución, la API de XTF invoca la función de devolución de llamada [OnFoundProcess](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess) de la interfaz [IXtfRunningProcessCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) implementada en su aplicación y especificada en `pCallback`. La API de XTF pasa un puntero a una estructura [XTFPROCESSINFO](/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo), que describe el proceso en ejecución, cuando invoca la función `OnFoundProcess` que usted ha implementado.

<Note>La memoria de la estructura [XTFPROCESSINFO](/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) pertenece a la API de XBOX Tools Framework (XTF) y se invalida después de cada invocación de su función de devolución de llamada [IXtfRunningProcessCallback::OnFoundProcess](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess). Debe copiar la información de la estructura si la necesita para un uso posterior.</Note>

<Note>Para obtener la lista de procesos que se ejecutan en la partición del título, debe anexar `/title` a la dirección proporcionada en [XtfCreateConsoleClient](/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m) al crear la instancia de [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient); de lo contrario, esta función devolverá la lista de procesos que se ejecutan en la partición del sistema.</Note>

Para obtener más información sobre cómo enumerar los procesos en ejecución mediante XBOX Tools Framework (XTF), consulte [Lista de procesos (xbtlist.exe) (tema NDA)](/tools/tools-console/commandlinetools/xbtlist).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

<a id="seealsoSection" />

## Consulte también

[IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfRunningProcessCallback](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [IXtfRunningProcessCallback::OnFoundProcess](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XTFPROCESSINFO](/es/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GetAllSettings](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)