ProfilerHitEx (Windows Embedded CE 6.0)

1/6/2010

This function implemented in the kernel is called by profiler interrupt service routines (ISR) to record a profiling sample.

Syntax

VOID ProfilerHitEx(
  OEMProfilerData* pData
);

Parameters

  • pData
    [in] Pointer to an OEMProfilerData structure containing hardware-specific profiling data.

Return Value

None.

Remarks

In the case of buffered and unbuffered profiler operation, ProfilerHitEx ignores all contents of pData except the return address.

In the case of CeLog profiling, ProfilerHitEx sends the contents of pData to the Celog data stream. For more information, see Celog and Kernel Tracker and CeLog Event Tracking.

If the profiler ISR generates interrupts with a timer, its calls to ProfilerHitEx produce standard Monte Carlo profiling, where samples are gathered at regular time intervals. For more information, see Monte Carlo Profiling.

If the profiler ISR generates interrupts on rollover events for various performance counters, its calls to ProfilerHitEx produce more general profiling, where samples are gathered at the intervals of those performance counters.

For example, if the OEM custom profiler generates interrupts after a specified number of instruction cache misses, the profiler report highlights the functions that generated the largest number of instruction cache misses, rather than the functions that consumed the largest amount of processor time.

You can use ProfilerHitEx to expose custom profiling data for a board support package (BSP).

Requirements

Header profiler.h
Library Nkstub.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

Kernel Functions
OEMProfilerData
ProfilerHit
ProfileStartEx