XtfCaptureOutputBegin
开始捕获调试输出。
语法
void XtfCaptureOutputBegin(
PCWSTR address,
XtfDebugStringCallback debugStringCallback,
XtfDebugStringErrorCallback debugStringErrorCallback,
PVOID context,
PHANDLE hListen
)
参数
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 主机工具）