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