跳轉到主要內容

PIXBeginCapture

啟動以程式設計方式控制的 PIX 計時擷取。

語法

參數

captureFlags   
類型:DWORD
指出要執行之擷取類型的旗標。一次只能將一個擷取旗標傳遞給 PIXBeginCapture。 captureParameters   _In_opt_
類型:PPIXCaptureParameters
若為計時擷取,請傳遞 TimingCaptureParameters 結構的指標,或傳遞包含 TimingCaptureParameters 結構之 PIXCaptureParameters 等位的指標。

傳回值

類型:HRESULT 指出是否已成功起始擷取。成功時會傳回 S_FALSE。一次只能執行一個擷取。如果在另一個擷取正在執行時呼叫 PIXBeginCapture,將會傳回 E_PENDING,且呼叫不會有任何作用。

旗標

備註

此函式會從遊戲程式碼起始 PIX 擷取。PIXBeginCapture 目前只能用來進行計時擷取 (NDA 主題)。 PIXBeginCapture 會將擷取資料儲存在主機上的工具記憶體中。可供擷取使用的工具記憶體數量,是透過設定 PIXCaptureParameters 結構中的 MaximumToolingMemorySizeMb 欄位來指定。 以程式設計方式進行的計時擷取可以使用兩種模式之一,由 PIXCaptureParameters 結構中 PIXCaptureStorage 列舉的值定義。當 PIXCaptureStorage 設定為 Memory 時,PIXBeginCapture 會填滿可用的工具記憶體,然後捨棄任何傳入的新資料。當 PIXCaptureStorage 設定為 MemoryCircular 時,PIXBeginCapture 會將工具記憶體當作環形緩衝區使用。擷取會執行到工具記憶體已滿為止,但不會停止擷取,而是將最舊的資料淘汰,以騰出空間給新資料。擷取會繼續執行。MemoryCircular 擷取的設計是長時間執行,同時不會耗盡主機上可用的工具記憶體。 使用 PIXBeginCapture 進行的計時擷取必須複製回 PC 並轉換為 .xpix 檔案,才能在 PIX 中檢視。如需在 PIX 中檢視程式設計擷取所需步驟的說明,請參閱開啟以程式設計方式進行的計時擷取 (NDA 主題)。 使用 PIXEndCapture 從遊戲程式碼停止 PIX 擷取。

需求

標頭: pix3.h 程式庫: pixevt.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

PIXEndCapture
PIXCaptureParameters
PIX3
PIX (NDA 主題)
最後修改於 2026年10月6日