setupComm 函数 (winbase.h)
初始化指定通信设备的通信参数。
语法
BOOL SetupComm(
[in] HANDLE hFile,
[in] DWORD dwInQueue,
[in] DWORD dwOutQueue
);
参数
[in] hFile
通信设备的句柄。 CreateFile 函数返回此句柄。
[in] dwInQueue
设备内部输入缓冲区的建议大小（以字节为单位）。
[in] dwOutQueue
设备内部输出缓冲区的建议大小（以字节为单位）。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
在进程使用 CreateFile 函数打开通信设备的句柄之后，但在对设备执行任何 I/O 之前，进程可以调用 SetupComm 来设置设备的通信参数。 如果未设置这些参数，则设备在首次调用另一个通信函数时使用默认参数。
dwInQueue 和 dwOutQueue 参数指定驱动程序为指定设备使用的内部缓冲区的建议大小。 例如，YMODEM 协议数据包略大于 1024 字节。 因此，对于 YMODEM 通信，建议的缓冲区大小可能为 1200 字节。 对于基于以太网的通信，建议的缓冲区大小可能为 1600 字节，这比单个以太网帧稍大一些。
设备驱动程序接收建议的缓冲区大小，但可以免费使用任何输入和输出 (I/O) 缓冲方案，只要它提供合理的性能并且数据不会因溢出 (而丢失，除非在极端情况下) 。 例如，即使驱动程序未分配缓冲区，该函数也可以成功，只要系统的其他部分提供等效的功能。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | winbase.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |