> ## 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/ko/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/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md) 인터페이스의 [OnFoundProcess](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) 콜백 함수를 호출합니다. XTF API는 구현된 `OnFoundProcess` 함수를 호출할 때 실행 중인 프로세스를 설명하는 [XTFPROCESSINFO](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md) 구조체에 대한 포인터를 전달합니다.

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

> [!NOTE]
>
> 타이틀 파티션에서 실행 중인 프로세스 목록을 가져오려면 [IXtfConsoleControlClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) 인스턴스를 만들 때 [XtfCreateConsoleClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md)에 지정된 주소에 `/title`을 추가해야 합니다. 그렇지 않으면 이 함수는 시스템 파티션에서 실행 중인 프로세스 목록을 반환합니다.

XBOX Tools Framework(XTF)를 사용하여 실행 중인 프로세스를 나열하는 방법에 대한 자세한 내용은 [프로세스 목록(xbtlist.exe)(NDA 항목)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbtlist.md)을 참조하세요.

## 요구 사항

**헤더:** xtfconsolecontrol.h

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

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

## 함께 보기

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


## Related topics

- [IXtfRunningProcessCallback (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)