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

# OnFoundProcess

> IXtfRunningProcessCallback::OnFoundProcess

# IXtfRunningProcessCallback::OnFoundProcess

実行中のプロセスが見つかったときに呼び出されます。

## 構文

```cpp theme={null}
HRESULT OnFoundProcess(
         LPCXTFPROCESSINFO pProcessData
)  
```

### パラメーター

*pProcessData*\
型: LPCXTFPROCESSINFO

実行中のプロセスに関する情報を含む [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 構造体へのポインターです。

### 戻り値

型: HRESULT

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

## 解説

このコールバック関数は、開発コンソール上で見つかった実行中のプロセスごとに [IXtfConsoleControlClient::GetRunningProcesses](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md) によって呼び出されます。この関数は、実行中のプロセスのプロセス ID とプロセス イメージ ファイル名を含む [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 構造体へのポインターを受け取ります。XBOX Tools Framework (XTF) を使用した実行中プロセスの一覧表示の詳細については、[Process list (xbtlist.exe) (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbtlist.md) を参照してください。

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

## 要件

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

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

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

## 関連項目

[IXtfRunningProcessCallback](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)\
[XtfConsoleControl](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[XBOX Tools Framework native API reference](https://docs.xbox.com/ja-jp/reference/tools/xtf/atoc-xtf-native.md)


## Related topics

- [IXtfRunningProcessCallback (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [GetRunningProcesses](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [XTFPROCESSINFO](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [process_incoming_data](https://docs.xbox.com/ja-jp/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [match_found](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Matchmaking/match-found.md)