| 外部インタフェース/API | |
イベントタイプとアクションプロパティ
シリアルポートイベントタイプと対応するアクションプロパティを以下に示します。
| イベントタイプ |
対応するプロパティ |
| Break interrupt |
BreakInterruptAction |
| Bytes available | BytesAvailableAction |
BytesAvailableActionCount |
|
BytesAvailableActionMode |
|
| Error |
ErrorAction |
| Output empty |
OutputEmptyAction |
| Pin status |
PinStatusAction |
| Timer | TimerAction |
TimerPeriod |
ブレーク割り込みイベント ブレーク割り込みイベントは、シリアルポートによるブレーク割り込みが発生した直後に生成されます。シリアルポートは、受信データが1キャラクタに対する送信時間よりも長く非アクティブ状態であるときにブレーク割り込みを生成します。
このイベントは、BreakInterruptActionプロパティに対して指定されたアクション関数を実行します。同期および非同期の読み込みおよび書き出し操作に対して生成されます。
Bytes-Availableイベント bytes-availableイベントは、あらかじめ決められたバイト数が入力バッファ内で利用可能であるか、BytesAvailableActionModeプロパティで指定されたようにターミネータが読み込まれた直後に生成されます。
BytesAvailableActionModeがbyteである場合、bytes-availableイベントは、BytesAvailableActionCountで指定されたバイト数が入力バッファ
に格納されるたびにBytesAvailableActionプロパティに対して指定されたアクション関数を実行します。BytesAvailableActionModeがterminatorである場合、アクション関数はTerminatorプロパティで指定されたキャラクタが読み込まれるたびに実行します。
エラーイベント エラーイベントは、エラーが発生した直後に生成されます。
このイベントは、ErrorActionプロパティに対して指定されたアクション関数を実行します。非同期の読み込みまたは書き出し操作中にのみ生成されます。
エラーイベントは、タイムアウトが発生したときに生成されます。タイムアウトは、読み込みまたは書き出し操作がTimeoutプロパティで指定した時間内に終了しなかった場合に発生します。エラーイベントは、無効なプロパティ値の設定のような設定エラーに対して生成されません。
Output-Emptyイベント output-emptyイベントは、出力バッファが空になった直後に生成されます。
このイベントは、OutputEmptyActionプロパティに対して指定されたアクション関数を実行します。非同期の書き出し操作中にのみ生成されます。
Pin Statusイベント pin statusイベントは、CD, CTS, DSR, RIピンに対して状態(ピンの値)が変化した直後に生成されます。これらのピンの説明は、シリアルポートの信号とピンの割り当てを参照してください。
このイベントは、PinStatusActionプロパティに対して指定されたアクション関数を実行します。同期および非同期の読み込みおよび書き出し操作に対して生成されます。
タイマイベント タイマイベントは、TimerPeriodプロパティで指定した時間が経過したときに生成されます。時間は、シリアルポートオブジェクトがデバイスに接続されたときからの相対時間です。
このイベントは、TimerActionプロパティに対して指定されたアクション関数を実行します。
| | イベントとアクションの利用 | イベント情報の格納 | |