ProfSampRate

3.0

  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.

Parameters

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.

Return Value

This function does not return a value.

Comments

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.

Example

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  */