KsSetupComm

此函式是否可用依装置支援项目而定。

初始化指定通讯装置的通信讯参数。

语法

BOOL KsSetupComm(
     HANDLE hFile,
     DWORD dwInQueue,
     DWORD dwOutQueue
);

参数

hFile：通讯装置的控制代码，KsCreateComm 函式回传此控制代码。

dwInQueue：建议的装置内部输入缓冲区大小（位元组）。

dwOutQueue：建议的装置内部输出缓冲区大小（位元组）。

回传值

若函式执行成功将回传 TRUE；失败将回传 FALSE。欲获取延伸错误资讯请呼叫 GetLastError。

备注

当处理序使用 KsCreateComm 来开启一通讯装置之控制代码，并在装置未执行任何 I/O 之前，此处理序可呼叫 KsSetupComm 以设定装置的通讯参数，若此设定未发生，装置将在第一次呼叫另一通讯函式时使用预设参数。

dwInQueue 与 dwOutQueue 参数规定了驱动器使用的内部缓冲区建议大小，以给指定装置使用。例如，YMODEM 协定封包较 1024 位元组大一些，因此 YMODEM 通讯的建议缓冲区大小可能为 1200 位元组；以为 Ethernet 主的通讯之建议缓冲区大小可能为 1600 位元组，较 Ethernet 单讯框稍大。

装置驱动器接收建议的缓冲区大小，但可以自由使用任何输入和输出 (I/O) 的缓冲方案，只要其效能合理且不会因资料超出而遗失数据（极端情况下除外）。例如，即使驱动器没有分配缓冲区，只要系统的其他部分提供等效功能，该函式也可成功执行。

范例

N/A

使用需求

	RT	Win32
最低支援版本	4.0	4.0
标头档	kscom.h	kscom.h
程式库	KsApi_Rtss.lib	ksapi.h

参见

KsCreateComm

KsCloseComm