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

# IXtfConsoleControlClient::GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

実行中のすべてのプロセスを列挙し、実行中のプロセスごとにコールバックを呼び出します。

<a id="syntaxSection" />

## 構文

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

<a id="parametersSection" />

### パラメーター

*pCallback*\
型: IXtfRunningProcessCallback\*

[IXtfRunningProcessCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) インターフェイスへのポインターで、実行中のプロセスが検出されたときに呼び出されます。

<a id="retvalSection" />

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT エラー コードを返します。

<a id="remarksSection" />

## 解説

この関数は、XBOX Tools Framework (XTF) API に対して、現在の開発コンソール上で実行中のすべてのプロセスを列挙させます。実行中のプロセスが見つかると、XTF API は、アプリで実装され `pCallback` で指定した [IXtfRunningProcessCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) インターフェイスの [OnFoundProcess](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess) コールバック関数を呼び出します。XTF API は、実装した `OnFoundProcess` 関数を呼び出す際に、実行中のプロセスを記述する [XTFPROCESSINFO](/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) 構造体へのポインターを渡します。

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

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

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

<a id="requirementsSection" />

## 要件

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

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

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

<a id="seealsoSection" />

## 関連項目

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


## Related topics

- [IXtfRunningProcessCallback](/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [IXtfRunningProcessCallback::OnFoundProcess](/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XTFPROCESSINFO](/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient](/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GetAllSettings](/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)