GetDLLVersionEx

Returns the version number (major, minor and revision) of the PerfUtil.dll in use.

Syntax

UINT32 GetDLLVersionEx(void);

Parameters

None

Return Values

Zero

Error.

Non-zero

• Bits 31:24 (high order byte) are the DLL major version number
• Bits 23:16 are the DLL minor version number
• Bits 15:0 are the DLL minor revision number

Remarks

None

GetDDVersionEx

Returns the version number (major, minor and revision) of the PERFDD device driver in use.

Syntax

UINT32 GetDDersionEx(void);

Parameters

None

Return Values

Zero

Error.

Non-zero

• Bits 31:24 (high order byte) are the DD major version number
• Bits 23:16 are the DD minor version number
• Bits 15:0 are the DD minor revision number

Remarks

None

IsDeviceDriverInstalled

Returns whether or not the PERFDD device driver has been installed.

Syntax

int IsDeviceDriverInstalled(void);

Parameters

None

Return Values

Zero

Device driver has not been installed.

Non-zero

Device driver has been installed.

Remarks

None

IsDebuggerHookedUp    [Windows]

Returns whether or not the PERFDD device driver detected a debugger attached to the system.

Syntax

int IsDebuggerHookedUp(void);

Parameters

None

Return Values

Zero

A debugger is not attached to the system.

Non-zero

A debugger is attached to the system.

Remarks

None

IsLimitedFunctionMode    [Windows]

Returns whether or not the tools are running in Limited Function mode. Limited Function mode in entered if any of the following conditions occur:

• Driver is not loaded.
• 32-bit OS, driver is loaded and can't hook dispatcher (unrecognized kernel).
• 64-bit OS, driver is loaded and can't hook dispatcher because there is no debugger attached.
• 64-bit OS, driver is loaded, can't hook dispatcher and a debugger is attached (unrecognized kernel).

Syntax

int IsLimitedFunctionMode(void);

Parameters

None

Return Values

Zero

Tools are not running in Limited Function mode.

Non-zero

Tools are running in Limited Function mode.

Remarks

None

RcToString

Returns the human-readable name for the given PerfUtil return code.

Syntax

const char * RcToString(int rc);

Parameters

rc

Return code returned by PerfUtil API.

Return Values

string

if valid PerfUtil return code.

string "Not a PerfUtil return code"

if not a PerfUtil return code.

Remarks

None

ProcessIsWow64

Returns whether or not the requested process is a 32-bit process running under Windows on Windows (WoW) in a 64-bit OS.
Always returns false on Linux.

Syntax

BOOL ProcessIsWow64(HANDLE h_process);

Parameters

h_process

Process handle.

Return Values

TRUE

Process specified by h_process handle is a 32-bit process.

FALSE

Process specified by h_process handle is not a 32-bit process.

Remarks

• TRUE is always returned when running a 32-bit OS.