Std_ReturnType

データ型名 Std_ReturnType【rte_sws_a_0046】

概要 API関数が返す「状態」と「エラー値」

Std_ReturnTypeの構造

この型はuint8で定義されており，値"0"はエラーが発生しなかったことを示すために使用する．

上位 7 即時通信基盤エラーフラグ

1：即時通信基盤エラーのエラー値である．

0：即時通信基盤エラーのエラー値でない．

(つまりアプリケーションエラー)

6 オーバーレイエラーフラグ

(このフラグの使用方法は返り値を返すAPIに依存する)

5 アプリケーションエラーの値に使用する 4

3 2 1 下位 0

3.3.1.1 通信基盤エラー

通信基盤エラーは以下の2種類に分類される．

エラー分類 内容

即時通信基盤エラー 現在使用しているデータに関連するエラーを示す．このエラーは，アプリ ケーションデータやアプリケーションエラーが受信できないようなエラー に対して，受信側で使用するエラーである．

Std_ReturnType型の即時通信基盤エラーフラグがセットされている場合，

このエラーであることを示す．

このエラーは排他的であり，即時通信基盤エラーはアプリケーションエラ ーを上書きする【rte_sws_2593】．また同時に複数の即時通信基盤エラーが 返されることはない．

オーバーレイエラー 現在使用しているデータの受信後に発生した通信イベント(例えばデータ 要素が古い，あるいはキューのオーバーフローによるデータ損失)に関連す るエラーを示す．

オーバーレイエラーはStd_ReturnType型に含まれるオーバーレイエラー フラグビットを使用して通知する【rte_sws_1318】．

このエラーは他のアプリケーションエラー，もしくは通信基盤エラーと併 用できる．

3.3.1.2 アプリケーションエラー

RTEは，以下のフォーマットで定義されたアプリケーションエラーをサポートする【rte_sws_2573】

・ 即時通信基盤エラーフラグが"0"に設定されたStd_ReturnTypeの下位6ビット．

アプリケーションエラーの値範囲

アプリケーションエラーは以下の範囲をとる．

最小値 1 最大値 63

アプリケーションエラーのエラーコード

アプリケーションエラーのエラーコードは，RTE_E_INVALIDを除きアプリケーションエラー定数

・ サーバランナブルの返した返り値

・ サーバランナブルの返した返り値＋オーバーレイフラグを設定した値．

RTEの現在のリリースでは，クライアントに「サーバランナブルの返した返り値＋オーバーレイフラ グを設定した値」を返すことはない．

3.3.1.3 定義済みエラーコード

RTE標準エラーコード定義

RTE APIが正常に終了した場合のStd_ReturnTypeの値はRTE_E_OK(=0)である【rte_sws_1058】．

それ以外の場合はエラーコードで，以下の値を定義する．

・ RTE_E_INVALID = 1【rte_sws_2594】

・ RTE_E_COM_STOPPED = 128【rte_sws_1060】

・ RTE_E_TIMEOUT = 129【rte_sws_1064】

・ RTE_E_LIMIT = 130【rte_sws_1317】

・ RTE_E_NO_DATA = 131【rte_sws_1061】

・ RTE_E_TRANSMIT_ACK = 132【rte_sws_1065】

・ RTE_E_NEVER_RECEIVED = 133【rte_sws_7384】

・ RTE_E_UNCONNECTED = 134【rte_sws_7655】

・ RTE_E_IN_EXCLUSIVE_AREA = 135【rte_sws_2739】

・ RTE_E_SEG_FAULT = 136【rte_sws_2757】

・ RTE_E_DEV_DEFECT = 191【nrte_sws_0270】

・ RTE_E_LOST_DATA = 64【rte_sws_2571】

・ RTE_E_MAX_AGE_EXCEEDED = 64【rte_sws_2702】

以上のエラーコード定義で規定された標準エラーは，RTEヘッダで定義される【rte_sws_1269】．

SCHM標準エラーコード定義

SCHM APIが正常に終了した場合のStd_ReturnTypeの値はSCHM_E_OK(=0)である

【rte_sws_7289】．

それ以外の場合はエラーコードで，以下の値を定義する．

・ SCHM_E_LIMIT = 130【rte_sws_7290】

・ SCHM_E_NO_DATA = 131【rte_sws_7562】

・ SCHM_E_TRANSMIT_ACK = 132【rte_sws_7563】

・ SCHM_E_IN_EXCLUSIVE_AREA = 135【rte_sws_2747】

・ SCHM_E_TIMEOUT = 129【rte_sws_7054】

・ SCHM_E_DEV_DEFECT = 191【nrte_sws_0335】

以上のエラーコード定義で規定された標準エラーは，RTEヘッダで定義される【rte_sws_7291】．