DosPerfSysCall - Parameters

ulCommand (ULONG) - input

Command

DosPerfSysCall accepts the following commands:

CMD_KI_RDCNT (0x63)

Read CPU utilization information in both uniprocessor and symmetric multi-processor (SMP) environments by taking a snapshot of the time stamp counters. To determine CPU utilization, the application must compute the difference between two time stamp snapshots using 64-bit arithmetic. See the example code for details.
CMD_SOFTTRACE_LOG (0x14)
Record software trace information.

ulParm1 (ULONG) - in/out

Command specific parameter 1

Parameter usage depends on the command specified:

CMD_KI_RDCNT

Pointer to an array of CPUUTIL structures, with one entry for each processor. On a 4-way SMP machine, the array definition would be:

  CPUUTIL CPUUtil[4];   /* For processor IDs 0, 1, 2, and 3 */

since processor numbers and arrays are both 0-based. ulParm1 would be set to the address of CPUUtil[0].

ulParm2 and ulParm3 are not used and should be set to zero.

CMD_SOFTTRACE_LOG
Major code for the trace entry in the range of 0 to 255. Major codes 184 (0x00b8) and 185 (0x00b9) have been reserved for customer use. Major code 1 is reserved for exclusive use by IBM.

ulParm2 (ULONG) - in/out

Command specific parameter 2

Parameter usage depends on the command specified:

CMD_KI_RDCNT

0 (reserved)
CMD_SOFTTRACE_LOG
Minor code for the trace entry in the range of 0 to 255.

ulParm3 (ULONG) - in/out

Command specific parameter 3

Parameter usage depends on the command specified:

CMD_KI_RDCNT

0 (reserved)
CMD_SOFTTRACE_LOG
Pointer to a HOOKDATA data structure.

ulrc (APIRET) - returns

Return Code.

DosPerfSysCall returns one of the following values:

• NO_ERROR 1
  ERROR_INVALID_FUNCTION
  For a full list of error codes, see Errors.

---

[Back: DosPerfSysCall Return Value - ulrc]
[Next: DosPerfSysCall - Remarks]