<Return[S]><Top>

SetCommMask

Declare Function Api_SetCommMask& Lib "kernel32" Alias "SetCommMask" (ByVal hFile&, ByVal dwEvtMask&)

Declare Function SetCommMask Lib "kernel32" Alias "SetCommMask" (ByVal hFile As Long, ByVal dwEvtMask As Long) As Long

特定の通信デバイスで監視する一連のイベントを指定する。

パラメータ
hFile
    通信デバイスのハンドルを指定する。CreateFile 関数が返すハンドルを使う。
dwEvtMask
    監視するイベントを指定する。0 を渡すと、どのイベントも監視しない。次の１つ以上の定数を組み合わせて渡すことができる。

    定数                   

意味                                                                                                                                               

    EV_BREAK

入力上でブレークを検出したとき。

    EV_CTS

CTS(送信可)信号の状態が変わったとき。

    EV_DSR

DSR(データセットレディ)信号の状態が変わったとき。

    EV_ERR

回線状態エラーが発生したとき。回線状態エラーには、CE_FRAME、CE_OVERRUN、CE_RXPARITY がある。

    EV_RING

呼び出し信号を検出したとき。

    EV_RLSD

RLSD(受信線信号検出)信号の状態が変わったとき。

    EV_RXCHAR

1 文字受信し、入力バッファに入れたとき。

    EV_RXFLAG

　

イベント文字を受信し、入力バッファに入れたとき。イベント文字はデバイスの DCB 構造体で指定する。この構造体を使ってシリアルポートを設定するには、SetCommState 関数を使う。

    EV_TXEMPTY

出力バッファの最後の文字を送信したとき。



戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    SetCommMask 関数は、特定の通信資源で監視できる一連のイベントを設定する。WaitCommEvent 関数に通信資源のハンドルを渡し

    て、イベントが発生するのを待機する。通信資源の現在のイベントマスクを取得するには、GetCommMask 関数を使う。