RTSSAPPINFO

Structure used to retrieve information about an active or auto-registered RTSS application.

Syntax

typedef struct _RTSSAPPINFO {
    TCHAR Process [MAX_PATH]
    DWORD ProcessId;
    DWORD Flags;
    DWORD ProcessorAffinity;
    DWORD ProcessorAffinityMask;
    DWORD Status;
}RTSSAPPINFO, *PRTSSAPPINFO;

Members

Process

The name of the process.

ProcessId

The ID of the process, which may match a process slot.

Flags

Flags that describe the current state of the process.

Flag

Description

LAUNCH_FLAG_LOCAL

Process uses local memory. This flag is set if any of the following conditions are true:

  • Use Local Memory is configured as the default on the Memory tab of the RTX Properties control panel.
  • The /l flag was used during startup or while launching the process.
  • If the application allocated local memory by calling RtAllocateLocalMemory.

LAUNCH_FLAG_NONPAGED

Process uses non-paged memory. This flag is set if any of the following conditions are true:

  • Request from Windows is configured as the default on the Memory tab of the RTX Properties control panel.
  • Use Local Memory is configured as the default on the Memory tab of the RTX Properties control panel but the /n flag was used during startup or while launching the process. The /n flag overrides the Use Local Memory setting and causes RTSS applications to request memory from the Windows non-paged pool whenever memory is allocated instead of using RTX local memory.

LAUNCH_FLAG_AUTO_START

The process is registered to run automatically at boot time.
Note:
This flag is only supported when the subsystem is set to run at boot time.

LAUNCH_FLAG_AFFINITY

Indicates the ProcessorAffinity parameter contains a valid value and was used.

LAUNCH_FLAG_AFFINITY_MASK

Indicates the ProcessorAffinityMask parameter contains a valid value and was used.

ProcessorAffinity

The number of the processor that the main thread of the application is running on. This parameter is only referenced if LAUNCH_FLAG_AFFINITY is set.

ProcessorAffinityMask

The mask of processors, in the form of a bitmask, that may be used for any of the process' child threads. This parameter is only referenced if LAUNCH_FLAG_AFFINITY_MASK is set. If you do not specify a ProcessorAffinityMask, the default processor mask for the RTSS system is used.

Status

Status of the process.

Status

Description

SERVICE_CONTINUE_PENDING

The service continue is pending.

SERVICE_PAUSE_PENDING

The service pause is pending.

SERVICE_PAUSED

The service is paused.

SERVICE_RUNNING

The service is running.

SERVICE_START_PENDING

The service is starting.

SERVICE_STOP_PENDING

The service is stopping.

SERVICE_STOPPED

The service is not running.

IntervalZero.com | Support | Give Feedback