ref_ver

iref_ver

概要

バージョン情報の参照

C言語形式

 ER      ref_ver ( T_RVER *pk_rver );

 ER      iref_ver ( T_RVER *pk_rver );

パラメータ

I/O	パラメータ	説明
O	T_RVER *pk_rver;	バージョン情報を格納する領域へのポインタ

【バージョン情報T_RVERの構造 】

typedef struct t_rver { UH maker; /*カーネルのメーカ・コード*/ UH prid; /*カーネルの識別番号*/ UH spver; /*ITRON仕様のバージョン番号*/ UH prver; /*カーネルのバージョン番号*/ UH prno[4]; /*カーネル製品の管理情報*/ } T_RVER;

機能

RI600PXのバージョン情報をpk_rverで指定された領域に格納します。

- maker
maker
は，このカーネルを作ったメーカを表します。RI600PXでは，ルネサスエレクトロニクスを意味する0x011Bが返ります。
なお，makerと同じ値がカーネル構成マクロTKERNEL_MAKERに定義されています。

- prid
prid
は，カーネルやVLSIの種類を区別する番号を表します。RI600PXでは，0x0004が返ります。
なお，pridと同じ値がカーネル構成マクロTKERNEL_PRIDに定義されています。

- spver
spver
は，カーネルの準拠する仕様を表します。RI600PXでは，0x5403が返ります。
なお，spverと同じ値がカーネル構成マクロTKERNEL_SPVERに定義されています。

- prver
prver
は，カーネルのバージョン番号を表します。
例えば，カーネルのバージョンがV1.02.03の場合は0x0123となります。
なお，prverと同じ値がカーネル構成マクロTKERNEL_PRVERに定義されています。

- prno
prno
は，製品管理情報や製品番号などを表します。RI600PXでは，すべてのprno[]に0x0000が返ります

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - pk_rver == NULL
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。 備考 タスクからiref_verを発行した場合，および非タスクからref_verを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（ref_verのみ） - 呼び出しタスクからのpk_rverが示す領域に対するオペランド・ライト・アクセス許可がない。