Open topic with navigation
RtssRun Graphical User Interface
Along with the RtssRun command-line utility, RTX includes a GUI-based
utility you can use to run an RTSS process in the RTSS environment, load
an RTSS DLL, and register an RTDLL.
When you use RtssRun to run an RTSS process, it scans the RTSS process
service slots for a free slot. It copies the RTSS executable image to
the target directory for the process slot and loads the process.
NOTE: You cannot use the RtssRun Graphical User Interface to run a process that Visual Studio can attach to for debugging. Instead, use the command line version with the /y flag. See RtssRun Usage.
To start RtssRun:
- From the Start menu, choose AllPrograms > IntervalZero > >
Tools > RtssRun. The RtssRun dialog box appears.
NOTE: The RtssRun
dialog box that is displayed depends on the default memory allocation
setting you have chosen on the Memory
tab of the RTX Properties control panel. If Request
from Windows is enabled on the Memory tab, the Use
local memory pool option is displayed in the RtssRun dialog box,
giving you the option to override the default. Conversely, if Request
from local memory pool is enabled on the Memory tab, the Use
nonpaged pool option is displayed.
- Enter the filename of the RTSS process or RTSS DLL
you want to start or the RTDLL that you want to register, including the file's path. If you are unsure of the
filename or path, click Browse
to navigate to it.
- Check the Suppress
warning box if you want to disable warning messages from appearing
on the screen.
- From Modes,
chose either Run RTSS process or Register RTDLL.
When running an RTSS process, you can elect
to use the following options:
- Use local
memory pool - Uses deterministically allocated memory from the
local RTX memory pool. This gives RTSS applications the ability to allocate
memory without having to request it from Windows. The local memory pool
is not allocated until it is needed. For more information, see RTX Properties
Memory
tab settings.
- Use nonpaged
pool - Uses non-paged memory from Windows. RTSS applications request
memory allocations from Windows when this option is checked. This option
is only displayed if Request
from local memory pool is enabled on the Memory
tab in RTX Properties.
- Register
to run at boot time - Starts the process early in the system boot
sequence. RTX must be enabled
at boot time for this to take effect.
- Ideal
Processor - In dedicated environments, sets the ideal
processor for the application.
- Affinity
Mask - In dedicated environments, specifies the set
of processors on which threads spawned from this process may run.
NOTE: Only processors that are configured to run RTSS processes are available
to select in the Affinity Mask option.
When registering an RTDLL, you can elect
to:
- Share between processes — Allows an RTDLL to be loaded by several processes at
the same time. Otherwise, only threads within a single process can simultaneously
load a particular RTDLL.
- Click OK.
NOTE: If the RTSS application you are trying to run has not be stamped by the StampTool, an error message will appear:
See StampTool for instructions on stamping RTSS applications.
