ProfileCaptureStatus (Windows CE 5.0)

Send Feedback

This function is used by applications to query the OEM profiler after it is running.

VOID ProfileCaptureStatus();

Parameters

None.

Return Values

None.

Remarks

You can use ProfileCaptureStatus to gather custom profiling data as supplied by the OEM for your BSP. For more information, see the documentation for your BSP.

Note   Depending on the OEM's custom profiler, you might need to call ProfileStartEx before calling ProfileCaptureStatus.

When an application calls ProfileCaptureStatus, the kernel makes a call to IOCTL_HAL_OEM_PROFILER with the flag PROFILE_OEM_QUERY. The kernel then inserts the result of the query into the CeLog data stream, as an event with identifier CELID_OEMPROFILER_HIT.

ProfileCaptureStatus provides a different way to gather data. Rather than setting up one or more counters to roll over periodically, users can leave all counters to count up from zero and then use ProfileCaptureStatus to take a snapshot of the counters at various times.

ProfileCaptureStatus does not return the data to the application; rather, it inserts the data into the CeLog data stream. Therefore, ProfileCaptureStatus is only useful in conjunction with CeLog data capture. For more information, see Celog.lib and Remote Kernel Tracker and CeLog Event Tracking.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Profiler.h.
Link Library: Coredll.lib.

See Also

ProfileStartEx | ProfileStart | IOCTL_HAL_OEM_PROFILER

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.