DevHlp_PerfSysTrace

From EDM2
Jump to: navigation, search

DevHlp_PerfSysTrace writes software trace information to the STRACE buffer.

Syntax

DevHelp_PerfSysTrace (Major, Minor, TraceSize, TraceData)

Parameters

Major (USHORT)
Minor (USHORT)
TraceSize (USHORT)
TraceData (PBYTE)

Return Code

  • AX = return code.

Possible values

0 NO_ERROR 
Data written to trace buffer.
32902 ERROR_NOMEMORY 
Trace buffer has not been allocated.

Remarks

A trace buffer must be allocated, wia the STRACE INIT command, before attempting to write trace data.

Tracing stops once the trace buffer fills up. No error indication is returned. Subsequent calls to DevHelp_PerfSysTrace return immediately without writing any data.

Example Code

C

#include "dhcalls.h"

USHORT APIENTRY DevHelp_PerfSysTrace (USHORT Major, USHORT Minor,USHORT TraceSize, PBYTE TraceData) 

Assembler

Calling Sequence in Assembler

    MOV   AX, MajorCode
    MOV   BX, TraceSize
    MOV   CX, MinorCode
    LDS   SI, TraceData
    MOV   DL, DevHlp_PerfSysTrace
    CALL  DevHlp
    JC    Error