다음을 통해 공유


IXtfConsoleControlClient::GetRunningProcesses

실행 중인 각 프로세스에 대한 콜백을 호출하여 실행 중인 모든 프로세스를 열거합니다.

구문

HRESULT GetRunningProcesses(
         IXtfRunningProcessCallback *pCallback
)  

매개 변수

pCallback
형식: IXtfRunningProcessCallback*

실행 중인 프로세스가 발견될 때 호출할 IXtfRunningProcessCallback 인터페이스의 포인터입니다.

반환 값

형식: HRESULT

성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 XTF(Xbox Tools Framework) API가 현재 개발 콘솔에서 실행 중인 모든 프로세스를 열거하도록 합니다. 실행 중인 프로세스가 발견되면, XTF API가 앱에서 구현되고 pCallback에서 지정된 IXtfRunningProcessCallback 인터페이스의 OnFoundProcess 콜백 함수를 호출합니다. XTF API는 구현된 OnFoundProcess 함수를 호출하는 경우 XTFPROCESSINFO 구조체의 포인터를 통과시키고, 실행 중인 프로세스 설명합니다.

참고 항목

XTFPROCESSINFO 구조체에 대한 메모리는 XTF(Xbox Tools Framework) API가 소유하고 IXtfRunningProcessCallback::OnFoundProcess 콜백 함수를 호출한 후 무효화됩니다. 나중에 사용하기 위해 필요한 경우 구조체에서 정보를 복사해야 합니다.

참고 항목

타이틀 파티션에서 실행 중인 프로세스 목록을 가져오려면 IXtfConsoleControlClient 인스턴스를 만들 때 XtfCreateConsoleClient 에서 지정된 주소에 /title(을)를 추가해야 합니다. 그렇지 않으면 이 함수는 시스템 파티션에서 실행 중인 프로세스 목록을 반환합니다.

Xbox 도구 프레임워크(XTF)를 사용하는 실행 프로세스 목록에 대한 자세한 내용은 프로세스 목록(xbtlist.exe)(NDA 항목)권한 부여 필요을 참조하세요.

요구 사항

헤더: xtfconsolecontrol.h

라이브러리: xtfconsolecontrol.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

IXtfConsoleControlClient
XtfConsoleControl