# RTC_GetTime

## Syntax

  `#include <nitro/rtc.h>`

      RTCResult RTC_GetTime( RTCTime* time );

## Arguments

time | Pointer to the buffer where time information will be stored.

## Return Values

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

## Description

This function reads time data from the real-time clock. It queries ARM7 for time data and returns the information once it is received. This is a synchronous version of the `RTC_GetTimeAsync` function.

## Note

This function requires a PXI interrupt for synchronization; do not call it when PXI interrupts are prohibited.

## See Also

`RTC_GetTimeAsync, RTC_SetTime, RTC_SetTimeAsync, RTCResult, RTCTime`

## Revision History

2005/03/08 Standardized the Japanese term for "interrupt."
2004/05/18 Initial version.

CONFIDENTIAL