void ProfSampRate(nRate286, nRate386) | |||||
int nRate286; | /* sample rate for non–386 enhanced mode | */ | |||
int nRate386; | /* sample rate for 386 enhanced mode | */ |
The ProfSampRate function sets the Microsoft Windows Profiler code-sampling rate.
nRate286
Specifies the sampling rate if the application is not running in 386 enhanced mode. The nRate286 parameter can be one of the following values:
Value | Sampling rate |
1 | 122.070 microseconds |
2 | 244.141 microseconds |
3 | 488.281 microseconds |
4 | 976.562 microseconds |
5 | 1.953125 milliseconds |
6 | 3.90625 milliseconds |
7 | 7.8125 milliseconds |
8 | 15.625 milliseconds |
9 | 31.25 milliseconds |
10 | 62.5 milliseconds |
11 | 125 milliseconds |
12 | 250 milliseconds |
13 | 500 milliseconds |
nRate386
Specifies the sampling rate, in milliseconds if the application is running in 386 enhanced mode. This value is in the range 1 through 1000.
This function does not return a value.
Only the rate parameter appropriate to the current mode is used; the other parameter is ignored.
The default rate is 2 milliseconds in 386 enhanced mode; in any other mode, the value is 5, which specifies a rate of 1.953125 milliseconds.
For more information about using Profiler, see Microsoft Windows Programming Tools.
The following example uses the ProfSampRate function to change the Profiler sampling rate to 1 millisecond in 386 enhanced mode:
ProfClear
(); /* clears existing buffer */ ProfSampRate(5, 1); /* changes sampling rate */