Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Causes all running processes to be enumerated, invoking a callback for each running process.
Syntax
HRESULT GetRunningProcesses(
IXtfRunningProcessCallback *pCallback
)
Parameters
pCallback
Type: IXtfRunningProcessCallback*
A pointer to the IXtfRunningProcessCallback interface, invoked when a running process is discovered.
Return value
Type: HRESULT
Returns S_OK if successful; otherwise, returns an HRESULT error code.
Remarks
This function causes the Xbox Tools Framework (XTF) API to enumerate all of the running processes on the current development console. When a running process is found, the XTF API invokes the OnFoundProcess callback function of the IXtfRunningProcessCallback interface implemented in your app and specified in pCallback. The XTF API passes a pointer to an XTFPROCESSINFO structure, describing the running process, when it invokes your implemented OnFoundProcess function.
Note
Memory for the XTFPROCESSINFO structure is owned by the Xbox Tools Framework (XTF) API and is invalidated after each invocation of your IXtfRunningProcessCallback::OnFoundProcess callback function. You must copy the information in the structure if you need it for later use.
Note
To get the list of processes running in the title partition you need to append /title to the address given in XtfCreateConsoleClient when creating the IXtfConsoleControlClient instance, otherwise this function will return the list of processes running in the system partition.
For more information about listing running processes using Xbox Tools Framework (XTF), see Process list (xbtlist.exe) (NDA topic)Authorization required.
Requirements
Header: xtfconsolecontrol.h
Library: xtfconsolecontrol.lib
Supported platforms: Windows (for Xbox console tools)