@CHIP-RTOS C Library V2.06 - RTOS API
RTX_Access_Filesystem
Reserve file access context space
for the calling task. int RTX_Access_Filesystem ( void ); Parameters
- -- none --
Return Value
- 0, success
-1 --> Failure (Too many tasks with file access)
Comments
- This API is deprecated. (However, it may still have some
diagnostic value to determine why file accesses are failing
or could be used to acquire the file access context space
ahead of time to assure the task's future file accesses
will succeed.)
It is no longer necessary that
a task use this API to gain access to the file system.
A task is automatically granted file system access when the
file system API is used, provided that the system has not
ran out of file access context space.
The file system supports registration of up to 15 tasks
at a time. Each DOS program's main task
is registered with the file system regardless of whether
or not that program uses the file system. A task's reservation
on the file system access context space remains in effect until that
task is deleted from the system. The DOS program main tasks
are deleted when the program terminates (or
terminates and stays resident).
Once a successful call to this API has been made, any further
calls perform no operation (at most one context slot is assigned
per task).
If this API returns a failure indication, then the number of tasks
registered with the file system has reached the limit and this
calling task is consequently not being granted access to the
file system.
See Also
RTOS API
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
documentation
for more details.
Supported since or modified in @CHIP-RTOS version-
SC12 | SC13 | SC11 | SC1x3 |
-
V1.20 | V1.20 | V1.20 | V1.05 |
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|