INFO: Results of Function Timing from Microsoft Source Profiler (185295)


The information in this article applies to:

  • The Source Profiler, when used with:
    • Microsoft Visual C++, 32-bit Editions 2.0
    • Microsoft Visual C++, 32-bit Editions 2.1
    • Microsoft Visual C++, 32-bit Editions 2.2
    • Microsoft Visual C++, 32-bit Editions 4.0
    • Microsoft Visual C++, 32-bit Editions 4.1
    • Microsoft Visual C++, 32-bit Enterprise Edition 4.2
    • Microsoft Visual C++, 32-bit Professional Edition 4.2
    • Microsoft Visual C++, 32-bit Enterprise Edition 5.0
    • Microsoft Visual C++, 32-bit Professional Edition 5.0
    • Microsoft Visual C++, 32-bit Enterprise Edition 6.0
    • Microsoft Visual C++, 32-bit Professional Edition 6.0
    • Microsoft Visual C++, 32-bit Learning Edition 6.0
This article was previously published under Q185295

SUMMARY

This article describes the output generated from the Microsoft Source Profiler and specifically focuses on the use of function timing. The sample output comes from a default MFC AppWizard-based application called ProfTest. Although it is not a complete listing of the output from this profile, it is sufficient to demonstrate the output results. A description of each entry presented in the "Sample Output" section follows in the "Output Description" section of this article.

MORE INFORMATION

Sample Output

   Profile: Function timing, sorted by time
   Date:    Wed Nov 05 23:37:00 1997

Program Statistics

      Command line at 1997 Nov 05 23:35: "C:\code\ProfTest\Debug\ProfTest"
      Total time: 88816.409 millisecond
      Time outside of functions: 86.090 millisecond
      Call depth: 21
      Total functions: 317
      Total hits: 23933
      Function coverage: 58.0%
      Overhead calculated 8
      Overhead average 8

Module Statistics for proftest.exe

      Time in module: 88730.319 millisecond
      Percent of time in module: 100.0%
      Functions in module: 317
      Hits in module: 23933
      Module function coverage: 58.0%

      Func             Func+Child      Hit
      Time       %     Time       %    Count  Function
      ---------------------------------------------------------

      86571.608  97.6  87316.863  98.4   70   CWinThread::PumpMessage(void)
                                              (mfc42d.dll)
        246.177   0.3    367.692   0.4  184   CMDIFrameWnd::DefWindowProcA
                                              (unsigned int,unsigned
                                              int,long) (mfc42d.dll)
        188.947   0.2    188.947   0.2  751   CView::AssertValid(void)
                                              (mfc42d.dll)
        171.866   0.2    172.011   0.2    1   CToolBar::Create(class CWnd
                                              *,unsigned long,unsigned int)
                                              (mfc42d.dll)
        144.324   0.2    940.322   1.1  517   CWnd::OnWndMsg(unsigned
                                              int,unsigned int,long,long *)
                                              (mfc42d.dll)
         94.550   0.1    314.706   0.4   69   CWinThread::
                                              PreTranslateMessage(struct
                                              tagMSG *) (mfc42d.dll)
         50.008   0.1  88727.904 100.0    1   AfxWinMain(struct HINSTANCE__
                                              *,struct HINSTANCE__ *,char
                                              *,int) (mfc42d.dll)

Output Description

Program Statistics:

Command line -

Time and date the application ran, and the complete command line issued by the profiler.

Total time -

Total application execution time. The time listed in milliseconds might not be completely accurate. Use the times as a relative measure.

Time outside of functions -

Time spent outside of any profiled functions. If a top level profiled function is called, no time is added to this value until that function returns.

Call depth -

The deepest level of functions called. For example, if function A calls function B which calls function C, the call depth is 3.

Total functions -

The number of functions listed in the output.

Total hits -

How many times the functions listed were executed.

Function coverage -

The percentage of time spent in the listed functions.

Overhead calculated -

A relative value that represents profiler overhead. This is not a measure of time, but a larger value indicates more time spent in overhead.

Overhead average -

The average overhead required for all profiles. This should be the same as the overhead calculated, unless you are merging multiple profiles.

Module Statistics:

These statistics are similar to the Program Statistics. They are useful when profiling multiple modules, such as an executable and dynamic link library.

Function Time:

In the Function Timing section of the Visual C++ online documentation, there is one error. The function time is in milliseconds, not seconds as it is stated in the documentation. The following excerpt is reprinted from the documentation with the correct measure for function time (milliseconds):

The Func Time column reports how much time it took for the function to run in milliseconds. The next column shows what percent of the total profile time is represented by the function time. Func+Child Time refers to the total time profiled for the function as well as any functions called by that function. The next column shows what percent of the total profile time is represented by the Func+Child time. The Hit Count column reports the number of times that the function was called. The Function column displays the decorated name of the function.

If a called function contains profiler information, then the Func+Child Time is greater than the Func Time.

REFERENCES

Visual C++ online documentation: search on "Function Timing"
Modification Type:MajorLast Reviewed:12/1/2003
Keywords:kbinfo KB185295
©2003 Microsoft Corporation. All rights reserved.