> ## 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](/reference/tools/pix3/functions/pixbegincapture) のパラメーターです。

## Syntax

```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;
```

### Members

*FileName*\
型: PWSTR

本体上のキャプチャのファイル名です。

*MaximumToolingMemorySizeMb*\
型: UINT32

キャプチャ データを保持するために使用されるツーリング メモリ内のバッファーの最大サイズ (MB 単位) です。\
キャプチャは、*CaptureStorage* の値に応じて、メモリ バッファーがいっぱいになったときに停止するか、またはツーリング メモリをリング バッファーとして使用します。

*CaptureStorage*\
型: PIXCaptureStorage

キャプチャのモードです。*Memory* に設定した場合、`PIXBeginCapture` は利用可能なツーリング メモリを埋めていき、その後に入ってくる新しいデータは破棄されます。*MemoryCircular* に設定した場合、`PIXBeginCapture` はツーリング メモリをリング バッファーとして使用します。キャプチャはツーリング メモリがいっぱいになるまで実行されますが、キャプチャを停止する代わりに、新しいデータのための領域を確保するために古いデータからエージ アウトされます。

*CaptureGpuTiming*\
型: BOOL

PIX GPU イベント、GPU ワーク、PIX GPU マーカー、および API マーカーを含む GPU タイミング データをキャプチャするかどうかを決定します。

*CaptureCallstacks*\
型: BOOL

コンテキスト スイッチのコール スタックをキャプチャするかどうかを決定します。

*CaptureCpuSamples*\
型: BOOL

CPU サンプルをキャプチャするかどうかを決定します。

*CpuSamplesPerSecond*\
型: UINT32

キャプチャする 1 秒あたりの CPU サンプル数です。

*CaptureFileIO*\
型: BOOL

DirectStorage および Win32 のファイル I/O をキャプチャするかどうかを決定します。

*CaptureVirtualAllocEvents*\
型: BOOL

仮想割り当てイベントをキャプチャするかどうかを決定します。

*CaptureHeapAllocEvents*\
型: BOOL

ヒープ割り当てイベントをキャプチャするかどうかを決定します。

*CaptureXMemEvents*\
型: BOOL

XMem 割り当てイベントをキャプチャするかどうかを決定します。

*CapturePixMemEvents*\
型: BOOL

タイトル定義のカスタム メモリ アロケーターによって行われた割り当てをキャプチャするかどうかを決定します。

*CapturePageFaultEvents*\
型: BOOL

ページ フォールト イベントをキャプチャするかどうかを決定します。

*CaptureVideoFrames*\
型: BOOL

ビデオ フレームをキャプチャするかどうかを決定します。

## Remarks

この共用体は、プログラムで制御される PIX タイミング キャプチャを開始するために [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture) によって使用されます。

`PixBeginCapture` は、[PixGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate) から返されるフラグも使用します。

## Requirements

**ヘッダー:** pix3.h

**サポートされているプラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## See also

[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)\
[PIX (NDA topic)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)


## Related topics

- [PIX3](/ja-jp/reference/tools/pix3/pix3_members.md)
- [XAppCaptureTakeScreenshot](/ja-jp/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XtfCaptureOutputEnd](/ja-jp/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XAppCaptureTakeDiagnosticScreenshot](/ja-jp/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureStopUserRecord](/ja-jp/reference/system/xappcapture/functions/xappcapturestopuserrecord.md)