Skip to main content

IXtfRunningProcessCallback::OnFoundProcess

Called when a running process is found.

Syntax

Parameters

pProcessData
Type: LPCXTFPROCESSINFO
Pointer to an XTFPROCESSINFO structure that contains information about the running process.

Return value

Type: HRESULT Returns S_OK if successful; otherwise, it returns an HRESULT error code.

Remarks

This callback function is invoked by IXtfConsoleControlClient::GetRunningProcesses for each running process found on the development console. This function receives a pointer to an XTFPROCESSINFO structure that contains the process ID and process image file name of a running process. For more information about listing running processes using XBOX Tools Framework (XTF), see Process list (xbtlist.exe) (NDA topic).
Memory for the XTFPROCESSINFO structure is owned by the XBOX Tools Framework (XTF) API and is invalidated after each invocation of this callback function. You must copy the information in the structure if you need it for later use.

Requirements

Header: xtfconsolecontrol.h Library: xtfconsolecontrol.lib Supported platforms: Windows (for XBOX console tools)

See also

IXtfRunningProcessCallback
XtfConsoleControl
XBOX Tools Framework native API reference
Last modified on August 20, 2026