> ## 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-CN/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-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md) 接口的 [OnFoundProcess](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) 回调函数。当 XTF API 调用你实现的 `OnFoundProcess` 函数时，它会传递一个指向描述该运行进程的 [XTFPROCESSINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 结构的指针。

> [!NOTE]
>
> [XTFPROCESSINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 结构的内存归 XBOX Tools Framework (XTF) API 所有，并在每次调用你的 [IXtfRunningProcessCallback::OnFoundProcess](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) 回调函数后失效。如果你稍后需要使用这些信息，则必须复制该结构中的信息。

> [!NOTE]
>
> 若要获取在标题分区中运行的进程列表，你需要在创建 [IXtfConsoleControlClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) 实例时，将 `/title` 追加到 [XtfCreateConsoleClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md) 中给出的地址；否则此函数将返回在系统分区中运行的进程列表。

有关使用 XBOX Tools Framework (XTF) 列出正在运行的进程的详细信息，请参阅 [进程列表 (xbtlist.exe) (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbtlist.md)。

## 要求

**头文件：** xtfconsolecontrol.h

**库：** xtfconsolecontrol.lib

**支持的平台：** Windows（适用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [IXtfRunningProcessCallback（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)