BuildCommDCBAndTimeoutsA 関数 (winbase.h)
デバイス定義文字列を適切なデバイス制御ブロック コードに変換し、デバイス制御ブロックに配置します。 この関数は、デバイスのタイムアウトの可能性を含め、タイムアウト値を設定することもできます。この点に関する関数の動作は、デバイス定義文字列の内容によって異なります。
構文
BOOL BuildCommDCBAndTimeoutsA(
[in] LPCSTR lpDef,
[out] LPDCB lpDCB,
[out] LPCOMMTIMEOUTS lpCommTimeouts
);
パラメーター
[in] lpDef
デバイス制御情報。 この関数は、この文字列を受け取り、それを解析し、lpDCBが指す
この文字列は、コマンドのコマンド ライン引数
"ボー" 部分文字列には、一覧表示されている任意の値 (ペア) を指定できます。 2 桁の値は、それらが表す関連付けられた値の最初の 2 桁です。 たとえば、11 は 110 ボー、19 は 19,200 ボーを表します。
"パリティ" 部分文字列は、パリティ ビットを使用して伝送エラーを検出する方法を示します。
値は "none"、"even"、"odd"、
"mark"、および "space"。
詳細については、TechNet の モード コマンド リファレンスを参照してください。
たとえば、次の文字列は、ボー レート 1200、パリティなし、8 データ ビット、1 ストップ ビットを指定します。
baud=1200 parity=N data=8 stop=1
[out] lpDCB
lpDefが指すデバイス制御情報文字列から情報を受信する DCB 構造体へのポインター。 この DCB 構造体は、通信デバイスの制御設定を定義します。
[out] lpCommTimeouts
タイムアウト情報を受け取る COMMTIMEOUTS 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
- その文字列に部分文字列 "to=on" が含まれている場合、関数は COMMTIMEOUTS 構造体の WriteTotalTimeoutConstant メンバーを 60000 に、他のすべてのメンバーを 0 に設定します。
- その文字列に部分文字列 "to=off" が含まれている場合、COMMTIMEOUTS のメンバーは 0 に設定されます。
- その文字列で "to={on|off}" 部分文字列が指定されていない場合、この関数は lpCommTimeouts内の
COMMTIMEOUTS 構造体無視します。
手記
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして BuildCommDCBAndTimeouts を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP |
| サポートされる最小サーバー | Windows Server 2003 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winbase.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |
関連項目
BuildCommDCB の
COMMTIMEOUTS を
DCB の
GetCommTimeouts の
SetCommTimeouts の