ProfileStart (Windows Embedded CE 6.0)

1/6/2010

This function starts the Windows Embedded CE instrumented kernel, or Monte Carlo profiling.

Syntax

VOID ProfileStart(
  DWORD dwUSecInterval,
  DWORD dwOptions
);

Parameters

  • dwUSecInterval
    [in] Interval, in microseconds, for each profile interrupt (sample). This can be changed, depending on the target device implementation.
  • dwOptions
    [in] Profile flags. The following table shows the possible values.

    Value Description

    PROFILE_BUFFER

    Monte Carlo profiling records samples to a buffer.

    PROFILE_CONTINUE

    Starts the profiler timer (starts/resumes the profiler sampling). Call ProfileStart with the PROFILE_STARTPAUSED flag before using this flag.

    PROFILE_KCALL

    KCALL profiling records kernel calls.

    PROFILE_OBJCALL

    Records object calls.

    PROFILE_PAUSE

    Stops the profiler timer (pauses the profiler sampling). Call ProfileStart with the PROFILE_STARTPAUSED flag before using this flag. The first parameter to ProfileStart is ignored when using PROFILE_PAUSE.

    PROFILE_STARTPAUSED

    Begins profiling with the profiler timer off. Profiler control variables are initialized, but the timer is not activated (no profiling samples are made). Use this flag simultaneously with PROFILE_BUFFER or PROFILE_OBJCALL as shown in the following code example:

    ProfileStart( 500, PROFILE_BUFFER | PROFILE_STARTPAUSED );

    Call ProfileStart with this flag before using PROFILE_PAUSE.

Return Value

None.

Requirements

Header profiler.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

Kernel Functions
ProfileStartEx
ProfileStop

Other Resources

Setting Up Monte Carlo Profiling