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

# GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

列舉所有執行中的處理序，並針對每個執行中的處理序叫用回呼。

## 語法

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

### 參數

*pCallback*\
類型：IXtfRunningProcessCallback\*

指向 [IXtfRunningProcessCallback](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) 介面的指標，在探索到執行中的處理序時叫用。

### 傳回值

類型：HRESULT

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

## 備註

此函式會讓 XBOX Tools Framework (XTF) API 列舉目前開發主機上所有執行中的處理序。找到執行中的處理序時，XTF API 會叫用您的應用程式中所實作並於 `pCallback` 中指定之 [IXtfRunningProcessCallback](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) 介面的 [OnFoundProcess](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess) 回呼函式。XTF API 在叫用您實作的 `OnFoundProcess` 函式時，會傳遞指向描述該執行中處理序之 [XTFPROCESSINFO](/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) 結構的指標。

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

> [!NOTE]
>
> 若要取得在遊戲分割區中執行的處理序清單，您必須在建立 [IXtfConsoleControlClient](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 執行個體時，在 [XtfCreateConsoleClient](/zh-TW/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m) 中提供的位址後面附加 `/title`，否則此函式會傳回在系統分割區中執行的處理序清單。

如需使用 XBOX Tools Framework (XTF) 列出執行中處理序的詳細資訊，請參閱[處理序清單 (xbtlist.exe) (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbtlist)。

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

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

## 另請參閱

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


## Related topics

- [IXtfRunningProcessCallback (介面內容)](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XTFPROCESSINFO](/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (介面內容)](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [Create Build With Process Based Server](/api-reference/multiplayerserver/create-build-with-process-based-server.md)