System 0x21


タイマ取得


【機能】

 タイマカウンタの現在値を取得します。

【関数】

 int TmGet( int no, unsigned int *value )
 {
   return trapa_svc( 0x21, pid, no, value );
 }

【入力】

 no タイマ番号 「タイマ取得」で取得した番号(0〜31)
 value カウンタ格納エリア タイマカウント値を格納する領域の先頭アドレス

【出力】

 リターンコード OK 正常終了
+0
+1
+2
+3
value+00
タイマカウント値がセットされます

ERR_PARAM パラメータエラー
ERR_INUSE タイマ番号は他プロセスで使用中

【解説】

 指定タイマ番号の現在のカウント値を返します。

 タイマ番号が範囲外の場合、タイマ番号が未使用の場合、タイマ番号が他のプロセスで使用されている場合、エラーを返します。

 タイマカウントを格納する領域のポインタがNULLの場合、または4バイト境界のアドレスを指していない場合は、エラーを返します。

【関連項目】

 タイマ開始 タイマ停止