7. MAINTENANCE
Below, the parameters that must be sent to the function for it to return the application information are described.
Input parameter Type Description
psAppName POINTER TO STRING Application name.
psTaskName POINTER TO STRING Task name.
pstTaskInfo
POINTER TO stTask-
Info
Pointer to receive the application informa-
tion.
Table 244: GetTaskInfo Input Parameters
The data returned by the function, through the pointer informed in the input parameters are described on table below.
Returned Parameters Size Description
dwCurScanTime DWORD
Task cycle time (execution) with 1 µs res-
olution.
dwMinScanTime DWORD
Task cycle minimum time with 1 µs reso-
lution.
dwMaxScanTime DWORD Task cycle maximum time 1 µs resolution.
dwAvgScanTime DWORD
Task cycle average time with 1 µs resolu-
tion.
dwLimitMaxScan DWORD
Task cycle maximum time before watch-
dog occurrence.
dwIECCycleCount DWORD IEC cycle counter.
Table 245: GetTaskInfo Output Parameters
Possible ERRORCODE:
NoError: success execution;
TaskNotPresent: the desired task does not exist.
Example of utilization in ST language:
PROGRAM UserPrg
VAR
sAppName : STRING;
psAppName : POINTER TO STRING;
sTaskName : STRING;
psTaskName : POINTER TO STRING;
pstTaskInfo : POINTER TO stTaskInfo;
TaskInfo : stTaskInfo;
Info : ERRORCODE;
END_VAR
//INPUTS:
sAppName := 'Application'; //Variable receives the application name.
psAppName := ADR(sAppName); //Pointer with application name.
sTaskName := 'MainTask'; //Variable receives task name.
psTaskName := ADR(sTaskName); //Pointer with task name.
pstTaskInfo := ADR(TaskInfo); //Pointer that receives task info.
//FUNCTION:
//Function call.
Info := GetTaskInfo (psAppName, psTaskName, pstTaskInfo);
//Variable Info receives possible function errors.
371