RTC_GetDateTime


C Specification

#include <nitro/rtc.h>
RTCResult RTC_GetDateTime( 
            RTCDate* date,
            RTCTime* time );

Description

This function reads date and time data from the real time clock. It queries ARM7 for date and time data, stores the information to caller-specified storage, and returns. This is a synchronous version of RTC_GetDateTimeAsync.

Cautions

This function requires a PXI interrupt for synchronization. It cannot be used in situations where PXI interrupts are prohibited. The RTC alarm interrupt permission status must be "enable" for this function to work properly with the real time clock. If the status is not "enable," the function returns an error.

Arguments

date Pointer to RTCDate where date information will be stored.
time Pointer to RTCTime where time information will be stored.

Return Values

If the request succeeds, it returns 0.
If the request fails, it returns some numeric value other than 0.

See Also

RTC_GetDateTimeAsync, RTC_SetDateTime, RTC_SetDateTimeAsync, RTCResult, RTCDate, RTCTime

Revision History

05/18/2004 Initial Version