On Time Logo
Home Search Site Map Contact

On Time RTOS-32 Documentation

Welcome

RTTarget-32

RTKernel-32

RTKernel-32 Programming Manual

RTKernel-32 Reference Manual

Module RTKernel-32

RTKernel-32 Configuration

Function RTKernelInit

Task Management

Enquiring Tasks

Function RTKCurrentTaskHandle

Function RTKGetTaskState

Function RTKGetTaskPrio

Function RTKGetTaskStack

Function RTKGetMinStack

Function RTKTaskInfo

Function RTKClearStatistic

Function RTKLoadSymbols

Function RTKStackDump

Function RTKFirstTask

Function RTKNextTask

Time

Semaphores

Mailboxes

Message Passing

Interrupt Handling

Memory Pools

Kernel Tracer

Spinlocks

Miscellaneous RTKernel-32 Operations

Module FineTime

Module Clock

Module Timer

Module RTCom

Module RTKeybrd

Module RTTextIO

Module CPUMoni

Module RTProf

RTFiles-32

RTIP-32

RTPEG-32

RTUSB-32
PreviousPrevious NextNext

Function RTKGetMinStack

Function RTKGetMinStack returns the least number of bytes that has been free on a task's stack since it was created:

unsigned RTKGetMinStack(RTKTaskHandle Handle);

Parameters

Handle

References the task whose stack to enquire. To enquire the stack of the current task, RTKGetTaskStack(RTKCurrentTaskHandle()) can be used.

return value

The least number of bytes that has been free on the task's stack since it was created.

RTKernel-32 initializes the stack memory of a task with the ASCII code of the letter 'S'. RTKGetMinStack searches the stack from bottom to top for a byte not having value 'S' to determine how far the stack has been used.

Depending on the system driver, RTKernel-32 may not be able to determine the stack limits of the main task. In this case, the value FFFFFFFFh is returned for it. The actual free stack space can never have this value.

Note that sufficient stack space for interrupts must be available at all times.

UpFunction RTKGetTaskStack

DownFunction RTKTaskInfo

Copyright © 1996,2022 On Time