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) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |