> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXCaptureParameters

> PIXCaptureParameters

# PIXCaptureParameters

[PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 的參數。

## 語法

```cpp theme={null}
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

擷取模式。設定為 *Memory* 時，`PIXBeginCapture` 會填滿可用的工具記憶體，然後捨棄任何傳入的新資料。設定為 *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](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 會使用此等位來啟動以程式設計方式控制的 PIX 計時擷取。

`PixBeginCapture` 也會使用 [PixGetCaptureState](/zh-TW/reference/tools/pix3/functions/pixgetcapturestate) 傳回的旗標。

## 需求

**標頭：** pix3.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture)\
[PIX (NDA 主題)](/zh-TW/tools/tools-console/pix/pix)\
[pix3](/zh-TW/reference/tools/pix3/pix3_members)


## Related topics

- [PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture.md)
- [PIX3 (API 內容)](/zh-TW/reference/tools/pix3/pix3_members.md)
- [FXLOUDNESS_PARAMETERS](/zh-TW/reference/audio/xaudio2xbox/structs/fxloudness_parameters.md)
- [XAppCaptureVideoCaptureSettings](/zh-TW/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XGameStreamingVideoFlags](/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)