RtcplSetTotalNumberOfProcessors

The function RtcplSetTotalNumberOfProcessors sets the total number of processors in the machine that the RTSS subsystem is aware of.

Syntax

BOOL RtcplSetTotalNumberOfProcessors(
    DWORD total
);

Parameters

total

An integer (1 to 8) that specifies the total number of processors in the machine that the RTSS subsystem is aware of.

Return Values

A non-zero value if the function succeeds

Remarks

In general, you should not have to adjust the total number of processors value unless the RTX installer did not accurately identify the number of physical processors in the system. This can occur for two reasons:

The default RTX dedicated configuration, created during installation, is based on the current configuration at the time of install. If numproc already exists in the current configuration, the installer sets the Total Number of Processors to the numproc value, regardless of the number of physical processors in the machine.
If you have a desktop operating system installed that limits the number of processors, the RTX installer will only recognize that limited number of processors.

If the RTX installer did incorrectly identify the number of physical processors in the system, you can correct the discrepancy using RtcplSetTotalNumberOfProcessors.

NOTE: Specifying more processors than what physically exists in the system can cause the RTSS subsystem to become unstable.

RtcplSetTotalNumberOfProcessors is not supported on uniprocessor systems. A call to RtcplSetTotalNumberOfProcessors on a uniprocessor system will fail with a value of ERROR_NOT_SUPPORTED for GetLastError.

Related RTX Properties Control Panel Features

Tab	Control tab
Dialog Box	Click the Modify button in the Boot Configuration area to open the Configure your system screen in the Product Activation dialog box.
Feature(s)	Total number of processor(s) settings.

Requirements

Header	RtxProp.h
Library	RtxProp.lib

| |