> ## 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/ja-jp/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/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md) インターフェイスの [OnFoundProcess](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) コールバック関数を呼び出します。XTF API は、実装した `OnFoundProcess` 関数を呼び出す際に、実行中のプロセスを記述する [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 構造体へのポインターを渡します。

> [!NOTE]
>
> [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 構造体のメモリは XBOX Tools Framework (XTF) API が所有しており、[IXtfRunningProcessCallback::OnFoundProcess](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) コールバック関数の各呼び出しの後に無効になります。この情報を後で使用する必要がある場合は、構造体の情報をコピーする必要があります。

> [!NOTE]
>
> タイトル パーティションで実行中のプロセスの一覧を取得するには、[IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) インスタンスを作成する際に [XtfCreateConsoleClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md) で指定するアドレスに `/title` を追加する必要があります。そうしない場合、この関数はシステム パーティションで実行中のプロセスの一覧を返します。

XBOX Tools Framework (XTF) を使用した実行中プロセスの一覧表示の詳細については、[Process list (xbtlist.exe) (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbtlist.md) を参照してください。

## 要件

**ヘッダー:** xtfconsolecontrol.h

**ライブラリ:** xtfconsolecontrol.lib

**サポートされるプラットフォーム:** Windows (XBOX コンソール ツール用)

## 関連項目

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


## Related topics

- [IXtfRunningProcessCallback (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl (API の内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)