StopProfile
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This function decrements the start/stop counter for the specified profiling level.
nLevel
dwID
Parameters
nLevel
Level of execution of the identifier specified in the dwID parameter.The following table shows possible values for the nLevel parameter.
Value Description PROFILE_GLOBALLEVEL
Global level settings affect all processes and threads in the profiling run.
PROFILE_PROCESSLEVEL
Process level settings affect all threads that are part of the process specified by the dwId parameter.
PROFILE_THREADLEVEL
Thread profiling level settings affect the thread specified by the dwId parameter.
dwID
Element the function applies to.For a global-level element, use only the PROFILE_CURRENTID value.
To specify a current process or thread, use PROFILE_CURRENTID value.
To specify a process or thread other than the current process or thread, use the identifier for the process or thread generated by the system.
Return Values
The following table shows the values that this function returns.
| Value | Description |
|---|---|
PROFILE_OK |
The call was successful. |
PROFILE_ERROR_NOT_YET_IMPLEMENTED |
The profiling function call, profiling level, or combination of call and level is not implemented. |
PROFILE_ERROR_MODE_NEVER |
The profiling mode was set to NEVER when the function was called. |
PROFILE_ERROR_LEVEL_NO_EXIST |
The profiling level specified by the nLevel parameter does not exist. |
PROFILE_ERROR_ID_NO_EXIST |
The profiling element specified by the dwId parameter does not exist. |
Remarks
The StartProfile function and the StopProfile function control the start/stop counter for the profiling level. The default value for the start/stop counter is one.
When the start/stop count is greater than zero, the start/stop state for the profiling level is ON. When the count is less than or equal to zero, the start/stop state is OFF.
When the start/stop state and the suspend/resume state are both ON, the profiling state for the level is ON. For a thread to be profiled, the global, process, and thread level states for the thread must be ON.
Requirements
| Header | cecap.h |
| Library | cecap.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Concepts
Call Profiler Data Collection Functions
StartProfile
Call Profiler Data Collection API Reference
Data Collection Control