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
キャプチャ モード。
[メモリ] に設定すると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 ファイル IO をキャプチャするかどうかを指定します。
CaptureVirtualAllocEvents
型: BOOL
仮想割り当てイベントをキャプチャするかどうかを指定します。
CaptureHeapAllocEvents
型: BOOL
ヒープ割り当てイベントをキャプチャするかどうかを指定します。
CaptureXMemEvents
型: BOOL
XMem 割り当てイベントをキャプチャするかどうかを指定します。
CapturePixMemEvents
型: BOOL
タイトル定義カスタム メモリ アロケーターを使用して行われた割り当てをキャプチャするかどうかを指定します。
CapturePageFaultEvents
型: BOOL
ページ エラー イベントをキャプチャするかどうかを決定します。
CaptureVideoFrames
型: BOOL
ビデオ フレームをキャプチャするかどうかを指定します。
解説
この共用体は、プログラムによって制御できる PIX キャプチャを開始するために、PIXBeginCapture によって使用されます。
PixBeginCapture は PixGetCaptureState が返すフラグも使用します。
要件
ヘッダー: pix3.h
サポートされているプラットフォーム: Xbox One ファミリ本体と Xbox Series 本体