<Return[G]><Top>

GetCommModemStatus

Declare Function Api_GetCommModemStatus& Lib "kernel32" Alias "GetCommModemStatus" (ByVal hFile&, lpModemStat&)

Declare Function GetCommModemStatus Lib "kernel32" Alias "GetCommModemStatus" (ByVal hFile As Long, lpModemStat As Long) As Long

モデムの制御レジスタ値を取得する。

パラメータ
hFile
    通信デバイスのハンドルを指定する。CreateFile 関数が返すハンドルを使う。
lpModemStat
    32 ビット変数へのポインタを指定する。変数には、モデム制御レジスタの現在の状態を示す値が格納される。この値は、次の定数の組み

    合わせになる。

    定数                 

意味                                                                                                                                          

    MS_CTS_ON

CTS(送信可)信号がオンである。

    MS_DSR_ON

DSR(データセットレディ)信号がオンである。

    MS_RING_ON

呼び出し信号がオンである。

    MS_RLSD_ON

RLSD(受信線信号検出)信号がオンである。


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

解説
    GetCommModemStatus 関数は、WaitCommEvent 関数を使って CTS 信号、RLSD 信号、DSR 信号、呼び出し信号を監視する場合

    に有効である。信号の状態変化を検出するには、WaitCommEvent 関数を使って待機し、次に GetCommModemStatus 関数を使って

    変化後の状態を調べる。
    ハードウェアが制御レジスタ値をサポートしない場合、この関数は失敗する。