Everything

ref_sem

iref_sem

概要
セマフォ詳細情報の参照
C言語形式
 ER      ref_sem ( ID semid, T_RSEM *pk_rsem );
 ER      iref_sem ( ID semid, T_RSEM *pk_rsem );
パラメータ
I/O
パラメータ
説明
I
 ID      semid;
セマフォのID
O
 T_RSEM  *pk_rsem;
セマフォ詳細情報を格納する領域へのポインタ

【 セマフォ詳細情報T_RSEMの構造 】
 typedef struct  t_rsem {
         ID      wtskid;         /*待ちタスクの有無*/
         UINT    semcnt;         /*現在資源数*/
 } T_RSEM;

機能
semidで指定されたセマフォのセマフォ詳細情報(待ちタスクの有無,現在資源数など)をpk_rsemで指定された領域に格納します。
- wtskid
セマフォの待ちキューにタスクがキューイングされているか否かが格納されます。
TSK_NONE: 待ちキューにタスクはキューイングされていない
その他: 待ちキューの先頭にキューイングされているタスクのID
- semcnt
セマフォの現在資源数が格納されます。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_ID
-18
不正ID番号
- semid≦0
- semidVTMAX_SEM
E_CTX
-25
コンテキスト・エラー
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
備考 タスクからiref_semを発行した場合,および非タスクからref_semを発行した場合,コンテキスト・エラーは検出されず,システムの正常な動作は保証されません。