SetupComm

指定した通信デバイスの通信パラメータを初期化する。

SetupComm hFile, dwInQueue, dwOutQueue

hFile : [intptr] 通信デバイスのハンドル。CreateFile 関数が返す。
dwInQueue : [int] デバイスの内部入力バッファの推奨サイズ（バイト単位）。
dwOutQueue : [int] デバイスの内部出力バッファの推奨サイズ（バイト単位）。

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

解説

指定した通信デバイスの通信パラメータを初期化する。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
プロセスが CreateFile で通信デバイスのハンドルを開いた後、デバイスとの I/O を行う前に SetupComm
を呼んで通信パラメータを設定できる。設定しない場合、最初の通信関数呼び出し時に既定パラメータが使われる。dwInQueue と
dwOutQueue は指定デバイスのドライバが使う内部バッファの推奨サイズを指定する。たとえば YMODEM プロトコルパケットは
1024 バイトより少し大きいので 1200 バイトが推奨され、Ethernet ベースの通信では 1600
バイトが推奨される。デバイスドライバは推奨バッファサイズを受け取るが、合理的な性能とオーバーランによるデータ損失なし（極端な状況を除く）を提供する限り、任意の
I/O バッファリング方式を自由に使える。

情報