IXtfRunningProcessCallback::OnFoundProcess

2025-04-28

Called when a running process is found.

Syntax

HRESULT OnFoundProcess(
         LPCXTFPROCESSINFO pProcessData
)

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)Authorization required.

Note

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)

Share via