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

在找到執行中的處理序時呼叫。

## 語法

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

### 參數

*pProcessData*\
類型：LPCXTFPROCESSINFO

指向 [XTFPROCESSINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 結構的指標，該結構包含執行中處理序的相關資訊。

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

## 備註

[IXtfConsoleControlClient::GetRunningProcesses](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md) 會針對在開發主機上找到的每個執行中處理序叫用此回呼函式。此函式會接收指向 [XTFPROCESSINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 結構的指標，該結構包含執行中處理序的處理序識別碼和處理序映像檔案名稱。如需使用 XBOX Tools Framework (XTF) 列出執行中處理序的詳細資訊，請參閱[處理序清單 (xbtlist.exe) (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbtlist.md)。

> [!NOTE]
>
> [XTFPROCESSINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 結構的記憶體由 XBOX Tools Framework (XTF) API 擁有，並會在每次叫用此回呼函式之後失效。如果您之後需要使用結構中的資訊，必須先複製這些資訊。

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[IXtfRunningProcessCallback](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)\
[XtfConsoleControl](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[XBOX Tools Framework 原生 API 參考](https://docs.xbox.com/zh-TW/reference/tools/xtf/atoc-xtf-native.md)


## Related topics

- [IXtfRunningProcessCallback (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [GetRunningProcesses](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [XTFPROCESSINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [process_incoming_data](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [match_found](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Matchmaking/match-found.md)