DosEstimateFreqCPU: Difference between revisions

Latest revision as of 20:05, 25 July 2023

This software is a dynalink library that estimates clock frequency of all available CPUs on 32-bit OS/2 environment.

It can be used any 32-bit development suites that can issue OS/2 APIs such as emx/gcc, VisualAge C++ or Watcom C/C++.

Function call

Estimates clock frequency of all available CPUs.

Syntax

#define INCL_BASE
#include <os2.h>
#include "FREQCPU.h"
 
APIRET ulrc = DosEstimateFreqCPU(PCPUFREQUENCY pxCPUFrequency);

Parameters

pxCPUFrequency (PCPUFREQUENCY) - output: Pointer to structure that estimated clock frequencies will be set to.

Return Code

ulrc (APIRET) - return: Return codes.; !NO_ERROR Error.; NO_ERROR Successful completion.

Remarks

This function estimates clock frequency of all available CPUs. Obtained frequency will be set to CPUFREQUENCY structure:

/* CPU frequency information structure */
typedef struct _CPUFREQUENCY
{
    ULONG ulNumCPUs;            /* # of available CPUs */
    FIXED afxFrequencyMHz[64];  /* frequency of each CPUs in FIXED MHz (65536 means 1.0) */
} CPUFREQUENCY, * PCPUFREQUENCY;

License

GNU LGPL
Author: Takayuki 'January June' Suwa / Beliefia Productions

Links

[freqcpu_r111.zip] (2001-10-31)

@@ Line 1: / Line 1: @@
-This software is a dynalink library that estimates clock frequency of all available CPUs on 32bit OS/2 environment.
+This software is a dynalink library that estimates clock frequency of all available CPUs on 32-bit OS/2 environment.
 It can be used any 32-bit development suites that can issue OS/2 APIs such as emx/gcc, VisualAge C++ or Watcom C/C++.
-;Function call: [[DosEstimateFreqCPU Function]]
+==Function call==
+Estimates clock frequency of all available CPUs.
-;License:GNU LGPL
+===Syntax===
+<PRE>
+#define INCL_BASE
+#include <os2.h>
+#include "FREQCPU.h"
+APIRET ulrc = DosEstimateFreqCPU(PCPUFREQUENCY pxCPUFrequency);
+</PRE>
-;Author:Takayuki 'January June' Suwa / Beliefia Productions
+===Parameters===
+;pxCPUFrequency (PCPUFREQUENCY) - output: Pointer to structure that estimated clock frequencies will be set to.
+===Return Code===
+; ulrc (APIRET) - return:Return codes.
+:!NO_ERROR Error.
+:NO_ERROR Successful completion.
+===Remarks===
+This function estimates clock frequency of all available CPUs. Obtained frequency will be set to CPUFREQUENCY structure:
+<PRE>
+/* CPU frequency information structure */
+typedef struct _CPUFREQUENCY
+{
+    ULONG ulNumCPUs;            /* # of available CPUs */
+    FIXED afxFrequencyMHz[64];  /* frequency of each CPUs in FIXED MHz (65536 means 1.0) */
+} CPUFREQUENCY, * PCPUFREQUENCY;
+</PRE>
+==License==
+*GNU LGPL
+*Author: Takayuki 'January June' Suwa / Beliefia Productions
 ==Links==
-*Download: [http://hobbes.nmsu.edu/download/pub/os2/dev/dll/freqcpu_r111.zip freqcpu_r111.zip] (2001-10-31)
+*[freqcpu_r111.zip] (2001-10-31)
 [[Category:C Libraries]]