RtProcess.Start Method (Dictionary, Object)
Starts an RTSS process via a dictionary that uses the StartParameters enumeration as the dictionary’s key type. Unrecognized keys in this dictionary are silently ignored.
Namespace:
IntervalZero.MaxRT.wRTOS.RtApi.Diagnostics
Assembly:
IntervalZero.MaxRT.wRTOS (in IntervalZero.MaxRT.wRTOS.dll) Version: 1.0.0.0 (File version: 1.0.1)
Syntax
public static RtProcess Start(
Dictionary <StartParameters,
object >StartParameters
)
public enum StartParameters {
FileName,
Arguments,
NoWaitThread,
IdealProcessor,
ProcessAffinityMask,
ExternalMSpaceInitialSize,
ExternalMSpaceExpandSize,
AllocateExtMSpaceAtStartup
};Values
FileName
Required. The valid file name of the RTSS process.
Arguments
Optional. The command line arguments to pass into the process.
NoWaitThread
Optional. If false a thread will be created to watch for when the process object that is returned is no longer running.
IdealProcessor
Optional. A thread attribute that specifies a processor on which the system should attempt to schedule the thread for execution.
ProcessAffinityMask
Optional. A bit mask indicating what processor(s) process should be run on by the scheduler.
ExternalMSpaceInitialSize
Optional. The initial size of the process external MSpace.
ExternalMSpaceExpandSize
Optional. The expand size of the process external MSpace.
AllocateExtMSpaceAtStartup
Optional. Specifies whether the process will allocate the process external MSpace at process start. If true a call to allocate the ExternalMSpaceInitialSize within the Subsystem occurs at process startup. If false the allocation occurs when the process first allocates memory that comes from the external process MSpace.
Exceptions
- wRTOSException – indicates an invalid parameter or a required parameter within the dictionary that has not been specified.
- MaxRTNativeException – indicates an error attempting to start the process in the C++ framework.
See Also:
