prcv_dtq

概要

データの受信(ポーリング)

C言語形式

 ER      prcv_dtq ( ID dtqid, VP_INT *p_data );
 

アセンブリ言語形式

 MOVW    BC, #LOWW(_data)
 MOV     A,  #dtqid
 CALL    !!_prcv_dtq
 

パラメータ

I/O

パラメータ

説明

I

 ID      dtqid;
データ・キューのID

O

 VP_INT  *p_data;
データを格納する領域へのポインタ



機能

dtqidで指定されたデータ・キューのデータ・キュー領域からデータを読み込み,p_dataで指定された領域に格納します。

ただし,本サービス・コールを発行した際,対象データ・キューのデータ・キュー領域からデータを読み込むことができなかった(データ・キュー領域にデータが書き込まれていなかった)場合には,データの読み込みは行わず,戻り値としてE_TMOUTを返します。

備考 本サービス・コールを発行した際,対象データ・キューのデータ・キュー領域からデータを読み込むことができなかった(データ・キュー領域にデータが書き込まれていなかった)場合,p_dataで指定された領域の内容は不定となります。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_TMOUT

-50

対象データ・キューのデータ・キュー領域にデータが書き込まれていない