Skip to main content

PIXEndCapture

停止使用 PIXBeginCapture 启动的以编程方式控制的捕获。

语法

参数

discard   
类型:BOOL
指示是否应丢弃捕获:
  • 如果 discard 为 TRUE,则丢弃已捕获的数据,捕获将不会显示在 PIX 中。
  • 如果 discard 为 FALSE,则保存已捕获的数据,PIX 将显示生成的捕获。
discard 参数对于丢弃不符合所寻求条件的捕获非常有用。例如,你可以使用 PIXBeginCapturePIXEndCapture 尝试捕获落在预定义时间范围内对某个函数的调用。你可能希望仅显示对某个函数在该范围内调用的捕获。

返回值

类型:HRESULT 指示捕获是否成功完成。成功时返回 S_OK。此操作是异步的,在捕获完全停止之前,它将返回 E_PENDING。在结果为 E_PENDING 时,游戏不应退出或启动新的捕获。

备注

使用 PIXBeginCapture 开始 PIX 捕获。
有关启动 PIX 捕获的要求的详细信息,请参阅 PIXBeginCapture 的备注部分。
下面的 C++ 示例演示了如何开始和结束 PIX 捕获。

要求

头文件: pix3.h 库: pixevt.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

PIXBeginCapture
PIX3
PIX(NDA 主题)
最后修改于 2026年8月24日