Skip to main content

XtfCaptureOutputBegin

开始捕获调试输出。

语法

参数

address
类型:PCWSTR
[in] 主机的 IP 地址。 debugStringCallback
类型:XtfDebugStringCallback
[in, optional] 针对每个输出调试字符串调用的可选回调。 debugStringErrorCallback
类型:XtfDebugStringErrorCallback
[in, optional] 针对遇到的每个错误调用的可选回调。 context
类型:PVOID
[in, optional] 一个指向对象的指针,该对象会被传入回调函数。此对象允许每次回调调用与此次捕获会话相关联。 hListen
类型:PHANDLE
[out] 表示此次捕获会话的句柄。

返回值

无。

备注

使用此函数和 XtfCaptureOutputEnd 函数来开始和停止捕获来自开发主机的一般调试输出。如果你想监视开发主机上特定进程 ID 的调试输出,请使用调试监视客户端。有关使用调试监视客户端的更多信息,请参阅 XtfCreateDebugMonitorClient 如果希望在捕获会话中捕获调试字符串,则必须实现并在 debugStringCallback 中指定一个 XtfDebugStringCallback 函数。同样,若要捕获捕获会话期间遇到的错误,必须实现并在 debugStringErrorCallback 中指定一个 XtfDebugStringErrorCallback 函数。但这两个回调函数都不是必需的。 若要停止捕获调试输出并释放与捕获会话关联的资源,请调用 XtfCaptureOutputEnd 并指定为该捕获会话在 hListen 中返回的句柄。
你必须调用 XtfCaptureOutputEnd 来停止捕获会话。否则,该捕获会话会成为孤立会话,与之关联的资源不会被释放,从而导致内存泄漏。

要求

头文件: xtfapi.h 库: XtfApi.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

IXtfDebugMonitorClient 接口
XTF 传输错误 (NDA 主题)
其他 Xtf API
最后修改于 2026年8月24日