> ## 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)를 사용하여 실행 중인 프로세스를 나열하는 방법에 대한 자세한 내용은 [프로세스 목록(xbtlist.exe)(NDA 항목)](/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)