{"id":6358,"date":"2024-01-03T10:22:18","date_gmt":"2024-01-03T18:22:18","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/pix\/?p=6358"},"modified":"2024-02-27T17:32:33","modified_gmt":"2024-02-28T01:32:33","slug":"circular-timing-captures","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/pix\/circular-timing-captures\/","title":{"rendered":"Circular Timing Captures"},"content":{"rendered":"

Starting with the 2402.07 version of PIX on Windows<\/a> and version 1.0.231030001 of the WinPIXEventRuntime<\/a>, Timing Captures<\/a> can now be run in a new “Circular”, or “ring-buffer” mode, in addition to the previously available “Sequential” mode.\u00a0 The new Circular mode is available both through the PIX UI and programmatically using the PIXBeginCapture<\/a> API.\u00a0 <\/span><\/p>\n

When capturing in Circular mode, PIX stores the capture data in a fixed sized buffer on disk. When the buffer is full, the oldest capture data is aged out to make room for newer data. Because the amount of space needed to store capture data is fixed, Circular captures can be run continuously.\u00a0 The on-disk buffer is stored in the user’s %TEMP% directory and is deleted when the capturing process is complete.<\/span><\/p>\n

The new Capture Mode<\/strong> setting in the PIX UI is used to choose between Circular<\/strong> and Sequential<\/strong> mode.<\/p>\n

 <\/p>\n

\"Image<\/a><\/p>\n

When Capture Mode<\/strong> is set to Circular<\/strong>, use the edit field or the slider to specify the size of the on-disk buffer.<\/p>\n

\"Image<\/a><\/p>\n

 <\/p>\n

Note that capturing GPU timings<\/strong> and GPU resources<\/strong> are not currently supported in Circular<\/strong> mode.<\/p>\n

Both Circular<\/strong> and Sequential<\/strong> capture are stopped from the PIX UI using the Stop Timing Capture<\/strong> button.<\/p>\n

Circular Timing Captures are particularly useful when taken programmatically using PIXBeginCapture<\/a>.\u00a0 In this scenario, a capture can be started and left running until a spike in frame time, or any other event that’s significant from a performance perspective, is detected.\u00a0 The capture can then be stopped using PIXEndCapture<\/a>.\u00a0 The resulting capture will contain the last N seconds of data, depending on the size of the on-disk buffer and the amount of capture data generated.<\/p>\n

Two values must be set in the PIXCaptureParameters<\/em> structure to enable Circular<\/strong> captures.\u00a0 First, specify the value PIXCaptureParameters::FileCircular<\/em> for the CaptureStorage<\/em> field. Next, set the MaximumToolingMemorySizeMb<\/em> field to specify the size of the on-disk buffer.\u00a0 Remember that your game must be running with administrator permissions to take a capture Timing Capture programmatically.<\/p>\n

Circular<\/strong> timing capture code sample:<\/p>\n

        #include pix3.h        \r\n         \r\n        g_hTimingCapturer = PIXLoadLatestWinPixTimingCapturerLibrary();\r\n        if (g_hTimingCapturer == NULL)\r\n        {\r\n            \/\/ process error\r\n        }\r\n\r\n        PIXCaptureParameters captureParams = {};\r\n\r\n        captureParams.TimingCaptureParameters.FileName = L\"c:\\\\captures\\\\hitch_detected.wpix\";\r\n        captureParams.TimingCaptureParameters.CaptureCpuSamples = true;\r\n        captureParams.TimingCaptureParameters.CaptureCallstacks = true;\r\n        captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;\r\n        captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 256;<\/strong>\r\n        captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::FileCircular;<\/strong>\r\n\r\n        HRESULT hrProgCapture = PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams);\r\n\r\n        if (!SUCCEEDED(hrProgCapture))\r\n        {\r\n            \/\/ process error\r\n        }\r\n        \r\n        \/\/ title code runs - stop the capture when an interesting performance event is detected\r\n        HRESULT hrEndCapture = PIXEndCapture(false);\r\n\r\n        if (!SUCCEEDED(hrEndCapture))\r\n        {\r\n            \/\/ process error\r\n        }<\/code><\/pre>\n
 <\/p>\n
As always, keep sending us bug reports and feature requests using the PIX Feedback button in the upper right corner of the PIX UI.<\/p>\n
Steven.<\/p>\n","protected":false},"excerpt":{"rendered":"
Starting with the 2402.07 version of PIX on Windows and version 1.0.231030001 of the WinPIXEventRuntime, Timing Captures can now be run in a new “Circular”, or “ring-buffer” mode, in addition to the previously available “Sequential” mode.\u00a0 The new Circular mode is available both through the PIX UI and programmatically using the PIXBeginCapture API.\u00a0 When capturing […]<\/p>\n","protected":false},"author":1915,"featured_media":6360,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-6358","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pix"],"acf":[],"blog_post_summary":"
Starting with the 2402.07 version of PIX on Windows and version 1.0.231030001 of the WinPIXEventRuntime, Timing Captures can now be run in a new “Circular”, or “ring-buffer” mode, in addition to the previously available “Sequential” mode.\u00a0 The new Circular mode is available both through the PIX UI and programmatically using the PIXBeginCapture API.\u00a0 When capturing […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/posts\/6358","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/users\/1915"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/comments?post=6358"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/posts\/6358\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/media\/6360"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/media?parent=6358"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/categories?post=6358"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/tags?post=6358"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}