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

# OnFoundProcess

> IXtfRunningProcessCallback::OnFoundProcess

# IXtfRunningProcessCallback::OnFoundProcess

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

## Sintaxe

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

### Parâmetros

*pProcessData*\
Tipo: LPCXTFPROCESSINFO

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

### Valor retornado

Tipo: HRESULT

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

## Comentários

Essa função de retorno de chamada é invocada por [IXtfConsoleControlClient::GetRunningProcesses](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md) para cada processo em execução encontrado no console de desenvolvimento. Essa função recebe um ponteiro para uma estrutura [XTFPROCESSINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 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)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbtlist.md).

> [!NOTE]
>
> A memória da estrutura [XTFPROCESSINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 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.

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

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


## Related topics

- [GetRunningProcesses](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [IXtfRunningProcessCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [XTFPROCESSINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [process_incoming_data](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [match_found](https://docs.xbox.com/pt-BR/services/playfab/api-references/events/Matchmaking/match-found.md)