SetCommState

デバイス制御ブロック (DCB 構造体) の指定に従って通信デバイスを構成する。すべてのハードウェアおよび制御設定を再初期化するが、出力キューや入力キューは空にしない。

SetCommState hFile, lpDCB

hFile : [intptr] 通信デバイスへのハンドル。CreateFileW 関数がこのハンドルを返す。
lpDCB : [var] 指定した通信デバイスの構成情報を含む DCB 構造体へのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

デバイス制御ブロック (DCB 構造体)
の指定に従って通信デバイスを構成する。すべてのハードウェアおよび制御設定を再初期化するが、出力キューや入力キューは空にしない。

[戻り値]
関数が成功した場合、戻り値は非ゼロである。失敗した場合はゼロである。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
SetCommState 関数は DCB 構造体を用いて希望する構成を指定する。GetCommState 関数は現在の構成を返す。DCB
構造体のうち一部のメンバのみを設定する場合、GetCommState 呼び出しで埋めた DCB
構造体を修正するとよい。こうすることで他のメンバに適切な値が入っていることが保証される。DCB 構造体の XonChar メンバが
XoffChar メンバと等しい場合、SetCommState 関数は失敗する。SetCommState を 8250
の構成に使用する場合、DCB 構造体の ByteSize と StopBits メンバの値に次の制限がある: データビット数は 5 から
8 ビットでなければならない。

情報