RtcplModifyDefaultRTXConfiguration

Use RtcplModifyDefaultRTXConfiguration to modify a multiprocessor system's default operating system boot-up behavior.

Syntax

BOOL RtcplModifyDefaultRTXConfiguration (
    
    DWORD RTX,
    DWORD Windows
);

Parameters

RTX

A DWORD that contains the number of processors to assign to RTX.

Windows

A DWORD that contains the number of processors to assign to Windows. If this is a uniprocessor system, Windows must equal 1.

Return Values

TRUE if the function succeeds in modifying the system's default operating system boot-up behavior, FALSE if the function fails

See "Comments" below for additional steps required for successful calls.

Remarks

A call to RtcplModifyDefaultRTXConfiguration may require a restart of the RTSS subsystem or a reboot of the machine; therefore, on a successful call, you should check GetLastError for one of the following:

Value	Required Action
ERROR_SUCCESS	The Mode or RTX values have been changed but the RTSS subsystem is not running, so no action is required.
ERROR_RESTART_REQUIRED	The Mode or RTX values have been changed and the RTSS subsystem is running. For your changes to take effect, you must restart the RTSS subsystem.
ERROR_REBOOT_REQUIRED	The Windows value has changed. For your changes to take effect, you must reboot the machine.

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)	Mode, Windows Processor(s), and RTSS Processor(s) settings.

Requirements

Header	RtxProp.h
Library	RtxProp.lib

| |