| IntervalZero.com | Support | Give Feedback |
|
|
|
RtssRun can be used to run an RTSS application to register an RTDLL.
Usage
RtssRun [/q]([/b][/l][/n][/a (affinity_mask)][/p ideal_processor])
| ([/d [/s][/f]])
filename.rtss
Parameters
/y
Creates a dynamic RTSS process that Visual Studio can attach to for debugging. When you use this flag to run a RTSS application, the RTSS process will appear in the Debug > Attach to Process dialog in Visual Studio.
NOTE: A boot-time process cannot be a dynamic process. As such, this parameter cannot be used with the parameter /b (create boot-time process).
NOTE: If you are launching an RTSS application that uses RTSS DLLs using RtCreateProcess, you must also launch the RTSS DLL using either RtCreateProcess or RtssRun with the /y option.
/q
This optional flag disables messages indicating success or failure of the RTX process to load. Without this flag, when RTSSRun fails, RTX displays a pop-up message box. When registering an RTDLL, if an RTDLL of the same name is already registered, it will not be overwritten unless you use the force flag.
/b
Configure process for boot time start.
NOTE: A boot-time process cannot be a dynamic process. As such, this parameter cannot be used with the parameter /y (create dynamic process).
/l
If Request from Windows is enabled on the Memory tab, the /l switch overrides this setting and causes RTSS applications to request memory from the RTX local memory pool instead whenever memory is allocated.
/n
If Request from local memory pool is enabled on the Memory tab, the /n switch overrides this setting and causes RTSS applications to request memory from the Windows non-paged pool instead whenever memory is allocated.
/a (1,2,...,31)
Affinity mask - specifies the processor affinity mask, as a list of comma-separated processor numbers, for the RTSS application about to run. For example:
RtssRun
/a(2,3)
Use integers to identify the processors and be sure to use system-wide processor numbers.
/p n
Ideal processor - sets the ideal processor for the RTSS application about to run. Use an integer to identify the processor and be sure to use its system-wide processor number.
/d
Register the RTDLL with the RTSS subsystem. This flag is required to register an RTDLL.
/s
Register the RTDLL as shared (requires the /d flag). This optional flag allows an RTDLL to be loaded by several processes at the same time. If this flag is not set, only threads within a single process can simultaneously load a particular RTDLL; all other loads will fail. If this flag is set, only one instance of the specified RTDLL is loaded, so global variables are shared.
/f
Force registration if another RTDLL of the same name is already registered (requires the /d flag).
filename
Full path to the RTSS application or the RTDLL.
[arg]
Parameters to the application being run.
Return Values
When starting an RTSS application:
When registering an RTDLL: