通过

PIXCaptureParameters

  • 项目

PIXBeginCapture 的参数。

语法

union PIXCaptureParameters
{
    enum PIXCaptureStorage
    {
        Memory = 0,
        MemoryCircular = 1, // Xbox only
        FileCircular = 2, // PC only
    };

    struct GpuCaptureParameters
    {
        PCWSTR FileName;
    } GpuCaptureParameters;

    struct TimingCaptureParameters
    {
        PCWSTR FileName;
        UINT32 MaximumToolingMemorySizeMb;
        PIXCaptureStorage CaptureStorage;

        BOOL CaptureGpuTiming;

        BOOL CaptureCallstacks;
        BOOL CaptureCpuSamples;
        UINT32 CpuSamplesPerSecond;

        BOOL CaptureFileIO;

        BOOL CaptureVirtualAllocEvents;
        BOOL CaptureHeapAllocEvents;
        BOOL CaptureXMemEvents; // Xbox only
        BOOL CapturePixMemEvents;
        BOOL CapturePageFaultEvents;
        BOOL CaptureVideoFrames; // Xbox only
    } TimingCaptureParameters;
};

typedef PIXCaptureParameters* PPIXCaptureParameters;

成员

FileName
类型：PWSTR

主机上捕获的文件名。

MaximumToolingMemorySizeMb
类型：UINT32

用于保存捕获数据的工具内存中缓冲区的最大 MB 数。
捕获将在内存缓冲区已满时停止，或者使用工具内存作为环形缓冲区，具体取决于 CaptureStorage 的值。

CaptureStorage
类型：PIXCaptureStorage

捕获模式。 如果设置为 MemoryPIXBeginCapture 将占满可用的工具内存，然后将放弃所有传入的新数据。 如果设置为 MemoryCircular，PIXBeginCapture 将工具内存用作环形缓冲区。 捕获将一直运行，直到工具内存已满，但不会停止捕获，而最早的数据会老化，以便为新数据腾出空间。

CaptureGpuTiming
类型：BOOL

确定是否捕获 GPU 计时数据，包括 PIX GPU 事件、GPU 工作、PIX GPU 标记和 API 标记。

CaptureCallstacks
类型：BOOL

确定是否捕获上下文切换的调用堆栈。

CaptureCpuSamples
类型：BOOL

确定是否捕获 CPU 样本。

CpuSamplesPerSecond
类型：UINT32

每秒捕获的 CPU 样本的数量。

CaptureFileIO
类型：BOOL

确定是否捕获 DirectStorage 和 Win32 文件 IO。

CaptureVirtualAllocEvents
类型：BOOL

确定是否捕获虚拟分配事件。

CaptureHeapAllocEvents
类型：BOOL

确定是否捕获堆分配事件。

CaptureXMemEvents
类型：BOOL

确定是否捕获 XMem 分配事件。

CapturePixMemEvents
类型：BOOL

确定是否捕获使用游戏定义的自定义内存分配器所做的分配。

CapturePageFaultEvents
类型：BOOL

确定是否捕获页面错误事件。

CaptureVideoFrames
类型：BOOL

确定是否捕获视频帧。

备注

PIXBeginCapture 使用此联合来启动以编程方式控制的 PIX 计时捕获。

PixBeginCapture 还使用 PixGetCaptureState 返回的标志。

要求

头文件：pix3.h

支持平台：Xbox One 系列主机和 Xbox Series 主机

另请参阅

PIXBeginCapture
PIX（NDA 主题）
pix3