{"id":5253,"date":"2021-02-01T16:59:23","date_gmt":"2021-02-02T00:59:23","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/pix\/?p=5253"},"modified":"2021-02-02T11:40:55","modified_gmt":"2021-02-02T19:40:55","slug":"function-summary-and-callgraph-captures-are-now-deprecated","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/pix\/function-summary-and-callgraph-captures-are-now-deprecated\/","title":{"rendered":"Function Summary and Callgraph captures are now deprecated"},"content":{"rendered":"

Function Summary<\/a> and Callgraph<\/a> captures are deprecated starting with the 2102.27 release of PIX on Windows<\/a>.<\/p>\n

The workflows supported by these legacy capture types have been replaced with enhancements we’re recently made to the Sampling Profiler<\/a> that is part of Timing Captures<\/a>.\u00a0 These enhancements include the ability to group the tree of aggregated CPU samples by thread or core, and the ability to designate a function as a focus function<\/em>.\u00a0 In addition,\u00a0 the integration of function data into Timing Captures enables some profiling scenarios that weren’t possible before, such as the ability to restrict the set of CPU samples you’re analyzing to be those that were collected during the time when one or more PIX events was executing.<\/p>\n

To access the Sampling Profiler, choose a sampling interval and select the CPU Samples<\/strong> checkbox when starting a capture.<\/p>\n

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

After the capture opens, an aggregated tree of the collected samples can be accessed by selecting Sampled Functions<\/strong> from the Items to show<\/strong> dropdown in the Range Details<\/strong> view.<\/p>\n

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

Function Summary Captures were commonly used to find a title\u2019s most expensive functions in terms of Inclusive and Exclusive duration. The Sampling Profiler now provides this capability via a flat function list that is created by aggregating the CPU samples collected while a Timing Capture is running. The function list can be accessed by selecting Function List<\/strong> in the Display Options<\/strong> panel while viewing Sampling Functions<\/strong>.<\/p>\n

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

Callgraph Captures were commonly used to analyze the full callgraph of a specified function to find the call path called most frequently, the path that took the longest to execute and so on. This capability is provided in the\u00a0Sampling Profiler\u00a0by allowing you to view the calltree based on a\u00a0focused function<\/em>. Selecting a function as a\u00a0focus function<\/em>\u00a0rebuilds the stack tree based on all calls to that function. The focused function becomes the top node in the tree with its entire calltree displayed as children. To select a function to focus on, right click on a function in the\u00a0Range Details<\/strong>\u00a0view and choose the\u00a0Set Focus Function<\/strong>\u00a0from the context menu.<\/p>\n

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

The stack tree will be rebuilt with the selected function as the focus. The options to group by thread and core, and to restrict the set of samples based on one or more PIX events can be used to further customize how the data is displayed. The following figure shows a stack tree with the function UpdateEnemyPositions as the focus function.<\/p>\n

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

If you should need to access the deprecated Function Summary or Callgraph Captures for any reason, you can do so by selecting the Enable legacy Callgraph and Function Summary capture types<\/strong>\u00a0checkbox on PIX\u2019s\u00a0Settings<\/strong>\u00a0page.<\/p>\n

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

Finally, if you used Function Summary or Callgraph captures for workflows that aren’t covered by the Sampling Profiler, be sure to let us know.\u00a0 Send us an email using the PIX Feedback button in the upper left corner of the PIX UI.<\/p>\n

Steven.<\/p>\n","protected":false},"excerpt":{"rendered":"

Function Summary and Callgraph captures are deprecated starting with the 2102.27 release of PIX on Windows. The workflows supported by these legacy capture types have been replaced with enhancements we’re recently made to the Sampling Profiler that is part of Timing Captures.\u00a0 These enhancements include the ability to group the tree of aggregated CPU samples […]<\/p>\n","protected":false},"author":1915,"featured_media":4769,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-5253","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pix"],"acf":[],"blog_post_summary":"

Function Summary and Callgraph captures are deprecated starting with the 2102.27 release of PIX on Windows. The workflows supported by these legacy capture types have been replaced with enhancements we’re recently made to the Sampling Profiler that is part of Timing Captures.\u00a0 These enhancements include the ability to group the tree of aggregated CPU samples […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/posts\/5253","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=5253"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/posts\/5253\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/media\/4769"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/media?parent=5253"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/categories?post=5253"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/pix\/wp-json\/wp\/v2\/tags?post=5253"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}