RTFW_SCHEDULED_PROCESS

RTFW_SCHEDULED_PROCESS is a structure that holds the data fields for a singe scheduled process.

Syntax

typedef struct _RTFW_SCHEDULED_PROCESS(
    size_t 		Size
    CHAR   		Filename[MAX_PATH],
    CHAR 		Parameters[MAX_PATH],
    bool 		UseLocalMemory,
    unsigned int 	IdealProcessor,
    uint64_t 		AffinityMask,
    RTFW_SCHEDULED_ID  ScheduledID
} RTFW_SCHEDULED_PROCESS, * PRTFW_SCHEDULED_PROCESS;

Members

Size

This field must always be set to the size of the structure before passing it into a function. If not set, the calling function returns False, and Last Error is set to RT_ERROR_STRUCTURE_TOO_SMALL.

Filename[MAX_PATH]

The filename or full pathname of the Scheduled Process. If a filename only is used, it will be validated against the current list of directories within the RTX64 SearchPath. If no file is found within the search path directories, this structure will be rejected with either ERROR_BAD_PATH or ERROR_FILE_NOT_FOUND.

Parameters[MAX_PATH] (Optional)

Contains the parameters that the process will be launched with. No validation is done for this field.

UseLocalMemory

Determines whether to use local memory (deterministic) or not. The default is to use Windows memory (non-deterministic).

IdealProcessor

Specifies the ideal processor for the Scheduled Process. If 0, it will use the first available processor. If an invalid processor is given, error INVALID PARAM is returned.

AffinityMask

Specifies the Process Affinity Mask. If 0, it will default to the Subsystem Affinity Mask. If non-zero, it must share at least 1 processor in common with the Subsystem Affinity mask. If an invalid affinity mask is given, error INVALID PARAM is returned.

ScheduledID

Specifies a unique identifier for a scheduled process, written to the structure when you call a create or get function with this structure. This field is used to identify scheduled processes for modification and deletion.

Requirements

Minimum Required Version	RTX64 3.5
Header	RtfwAPI.h
Library	RtfwAPI.lib