# RTC_GetTimeAsync

## 構文

  `#include <nitro/rtc.h>`

      RTCResult RTC_GetTimeAsync(
                  RTCTime*    time,
                  RTCCallback callback,
                  void*       arg );

## 引数

time | 時刻データを取得するバッファへのポインタ
callback | コールバック関数へのポインタ このコールバックは割り込みハンドラ内から呼び出されます。
arg | コールバック関数へ渡す引数

## 返り値

要求が成功した場合に 0 を返します。
要求が失敗した場合には 0 以外を返します。

## 説明

リアルタイムクロックから非同期的に時刻データを読み出します。
この関数はARM7に時刻データ読み出し要求を発行し、ARM7からの応答を待たずに呼び出し元に戻ります。
ARM7における処理結果はユーザコールバック関数に渡されるresult引数によって取得する必要があります。
この関数が失敗した場合は非同期的な操作は行われず、ユーザコールバック関数も呼び出されません。

## 注意

time引数によって指定したバッファには関数とは非同期に値が書き込まれますので、ユーザコールバック関数によって非同期処理の完了を確認するまでは別の用途に使用しないようにして下さい。

## 参照

`RTC_GetTime, RTC_SetTime, RTC_SetTimeAsync, RTCResult, RTCTime, RTCCallback`

## 履歴

2005/06/27 コールバックが割り込みハンドラから呼び出される旨を補足
2004/05/18 初版