Everything

ref_dtq

iref_dtq

概要
データ・キュー詳細情報の参照
C言語形式
 ER      ref_dtq ( ID dtqid, T_RDTQ *pk_rdtq );
 ER      iref_dtq ( ID dtqid, T_RDTQ *pk_rdtq );

パラメータ
I/O
パラメータ
説明
I
 ID      dtqid;
データ・キューのID
O
 T_RDTQ  *pk_rdtq;
データ・キュー詳細情報を格納する領域へのポインタ

【 データ・キュー詳細情報T_RDTQの構造 】
 typedef struct  t_rdtq {
         ID      stskid;         /*データ送信待ちタスクの有無*/
         ID      rtskid;         /*データ受信待ちタスクの有無*/
         UINT    sdtqcnt;        /*未受信データの総数*/
         ATR     dtqatr;         /*属性*/
         UH      RFU1;           /*システム予約領域*/
         UINT    dtqcnt;         /*データ数*/
         ID      memid;          /*システム予約領域*/
         UH      RFU2;           /*システム予約領域*/
 } T_RDTQ;

機能
dtqidで指定されたデータ・キューのデータ・キュー詳細情報(待ちタスクの有無,未受信データの総数など)をpk_rdtqで指定された領域に格納します。
備考 データ・キュー詳細情報T_RDTQについての詳細は,「15.2.5 データ・キュー詳細情報」を参照してください。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_ID
-18
IDの指定が不正である
- dtqid≦0x0
- dtqid>生成されているデータ・キューの最大ID
E_CTX
-25
CPUロック状態から本サービス・コールを発行した
E_NOEXS
-42
対象データ・キューが生成されていない