> ## 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/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 구조체에 대한 포인터입니다.

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

## 설명

이 콜백 함수는 개발 콘솔에서 발견된 각 실행 중인 프로세스에 대해 [IXtfConsoleControlClient::GetRunningProcesses](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)에 의해 호출됩니다. 이 함수는 실행 중인 프로세스의 프로세스 ID와 프로세스 이미지 파일 이름이 포함된 [XTFPROCESSINFO](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 구조체에 대한 포인터를 받습니다. XBOX Tools Framework(XTF)를 사용하여 실행 중인 프로세스를 나열하는 방법에 대한 자세한 내용은 [프로세스 목록(xbtlist.exe)(NDA 항목)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbtlist.md)을 참조하세요.

> [!NOTE]
>
> [XTFPROCESSINFO](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 구조체의 메모리는 XBOX Tools Framework(XTF) API가 소유하며 이 콜백 함수가 호출될 때마다 무효화됩니다. 나중에 사용해야 하는 경우 구조체의 정보를 복사해야 합니다.

## 요구 사항

**헤더:** xtfconsolecontrol.h

**라이브러리:** xtfconsolecontrol.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

## 함께 보기

[IXtfRunningProcessCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)\
[XtfConsoleControl](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[XBOX Tools Framework 네이티브 API 참조](https://docs.xbox.com/ko/reference/tools/xtf/atoc-xtf-native.md)


## Related topics

- [GetRunningProcesses](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [IXtfRunningProcessCallback (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [XTFPROCESSINFO](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [process_incoming_data](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [match_found](https://docs.xbox.com/ko/services/playfab/api-references/events/Matchmaking/match-found.md)