RtfwSetDefaultIdealProcessor

The RtfwSetDefaultIdealProcessor function sets the default core where the subsystem will run a process' main thread unless an ideal processor is provided when running the process.

Syntax

bool RtfwSetDefaultIdealProcessor(
    [in] DWORD DefaultIdealProcessor
);

Parameters

[in] DefaultIdealProcessor

The identifier of the default ideal processor.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.

Remarks

• The default value for DefaultIdealProcessor is 0xFFFFFFFF, which indicates that the system will assign the first available core as the Ideal Processor.

• The DefaultIdealProcessor value must be less than the total number of system processors.

• If the DefaultIdealProcessor value is less than the value of the first core available to the Subsystem, the default will be the first Subsystem core. For example, if you were to specify a default value of 1 on a system with 4 total cores and 2 cores (0 and 1) assigned to Windows, the default would be 2 (the first available Subsystem core).

• The DefaultIdealProcessor value does not change the default core for system threads.

• If the DefaultIdealProcessor value is set to a value greater than the largest RTSS core, the system will default to the first core assigned to the Subsystem.

Requirements

See Also: