#include <nitro/rtc.h>RTCResult RTC_GetTimeAsync(
RTCTime* time,
RTCCallback callback,
void* arg );| time | Pointer to RTCTime, where time information will be stored. |
| callback | Pointer to the callback function. This callback is called from within the interrupt handler. |
| arg | The argument to be passed to the Callback function. |
If the request succeeds, it returns 0.
If the request fails, it returns some numeric value other than 0.
This function asynchronously reads time data from the real time clock. It queries ARM7 for time data and returns those values without waiting for a response from the processor. To get the result from the processor, you must use the result argument. If this function fails, no operation is performed and no user callback function is called.
Values are written to the RTCTime specified by the time argument asynchronously with respect to the function. Do not use this variable for anything else until a user callback function confirms the completion of this asynchronous operation.
RTC_GetTime, RTC_SetTime, RTC_SetTimeAsync, RTCResult, RTCTime, RTCCallback
06/27/2005 Added additional text indicating that the callback is called from the interrupt handler.
05/18/2004 Initial version
CONFIDENTIAL