IXtfConsoleControlClient::GenerateStackDump
生成堆栈转储。语法
参数
ProcessId类型:UINT32 要为其创建堆栈转储的进程的标识符。 DumpType
类型:UINT32 要创建的堆栈转储类型。有效的转储类型为:
ImageName
类型:LPCWSTR 映像的名称。 FilePath
类型:LPBSTR 指向接收所创建堆栈转储文件的文件路径的字符串的指针。
返回值
类型:HRESULT 如果成功,则返回S_OK;否则返回 HRESULT 错误代码。如果函数在等待堆栈转储完成时超时,此函数将返回 E_MESSAGE_TIMED_OUT。
备注
此函数为开发主机上的可执行映像从指定进程生成堆栈转储。堆栈转储将作为文件保存到主机的暂存驱动器上,路径由FilePath 返回。
堆栈转储捕获的信息以及捕获该信息所需的时间取决于 DumpType 中指定的转储类型。此函数在 5 分钟后超时;如果在函数超时之前主机未返回堆栈转储,则此函数返回 E_MESSAGE_TIMED_OUT。下表描述了每种堆栈转储类型返回的信息。
有关可用的工具和自动化 API(例如 XBOX Tools Framework (XTF))的详细信息,请参阅 工具和自动化 API (NDA 主题)。
处理 LPBSTR 指针
有关处理此函数返回的 LPBSTR 指针的详细信息,请参阅 为 BSTR 分配和释放内存。要求
头文件: xtfconsolecontrol.h 库: xtfconsolecontrol.lib 支持的平台: Windows(适用于 XBOX 主机工具)另请参阅
XtfConsoleControlXBOX Tools Framework
