This API allows an application program to gain read/write permission into an object that is either in another program or the system's hardware area.
By default programs can only write into their own memory area. Access to other programs memory is read-only and the system's hardware areas are not addressable.
This API can be used to access such areas with the following restrictions:
System memory, below Effective Address 0x10000000 is off limits. This API will fail with error code RTX_EC_INVALID_PTR in this case.
This API may not be used from within a kernel timer callback. Doing so will fail with error code RTX_EC_NO_SUCH_PROCESS.
No reference to an object on the stack of a system callback is permitted. An error code RTX_EC_INVALID_PTR is returned in this case.
This API must be called from a task. Calling from an Interrupt Service Procedure will fail with error code RTX_EC_NO_SUCH_PROCESS.
|object ||Pointer to object to which read/write access is desired. |
|size ||Size of object, in bytes |
- 0 on success, else error code.
- The API does not exists in the SC1x, SC2x and SC1x3 C-Library.
- SC2x3 V1.00 - CLIB V1.00