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

# GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

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

## 語法

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

### 參數

*pCallback*\
類型：IXtfRunningProcessCallback\*

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

### 傳回值

類型：HRESULT

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

## 備註

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

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

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

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

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

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

## 另請參閱

[IXtfConsoleControlClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [IXtfRunningProcessCallback (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)