setupComm 函数 (winbase.h)

项目
08/27/2023

初始化指定通信设备的通信参数。

语法

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

另请参阅

setupComm 函数 (winbase.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源