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

# IXtfRunningProcessCallback::OnFoundProcess

> IXtfRunningProcessCallback::OnFoundProcess

# IXtfRunningProcessCallback::OnFoundProcess

Chamado quando um processo em execução é encontrado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT OnFoundProcess(
         LPCXTFPROCESSINFO pProcessData
)  
```

<a id="parametersSection" />

### Parâmetros

*pProcessData*\
Tipo: LPCXTFPROCESSINFO

Ponteiro para uma estrutura [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) que contém informações sobre o processo em execução.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

<a id="remarksSection" />

## Comentários

Essa função de retorno de chamada é invocada por [IXtfConsoleControlClient::GetRunningProcesses](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses) para cada processo em execução encontrado no console de desenvolvimento. Essa função recebe um ponteiro para uma estrutura [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) que contém a ID do processo e o nome do arquivo de imagem do processo de um processo em execução. Para obter mais informações sobre como listar processos em execução usando o XBOX Tools Framework (XTF), consulte [Lista de processos (xbtlist.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbtlist).

<Note>A memória da estrutura [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) pertence à API do XBOX Tools Framework (XTF) e é invalidada após cada invocação dessa função de retorno de chamada. Você deve copiar as informações da estrutura se precisar delas para uso posterior.</Note>

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

**Plataformas com suporte:** Windows (para ferramentas do console XBOX)

<a id="seealsoSection" />

## Confira também

[IXtfRunningProcessCallback](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback)\
[XtfConsoleControl](/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[Referência da API nativa do XBOX Tools Framework](/pt-BR/reference/tools/xtf/atoc-xtf-native)


## Related topics

- [IXtfConsoleControlClient::GetRunningProcesses](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfRunningProcessCallback](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [XtfGetTitleProcessMemoryReports](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md)
- [Create Build With Process Based Server](/api-reference/multiplayerserver/create-build-with-process-based-server.md)