KsSetCommMask

此函式是否可用依裝置支援項目而定。

指定要為通訊裝置監視的一組事件。

語法

BOOL KsSetCommBreak(
     HANDLE hFile,
     DWORD dwEvtMask
);

參數

hFile：通訊裝置的控制代碼，KsCreateComm 函式回傳此控制代碼。

dwEvtMask：欲啟用的事件，值設為零將停用所有事件。此參數可為下列一個或多個值：

值	說明
EV_BREAK 0x0040	輸入偵測到中斷。
EV_CTS 0x0008	清除發送 (clear-to-send, CTS) 訊號狀態改變。
EV_DSR 0x0010	資料集備妥 (data-set-ready, DSR) 訊號狀態改變。
EV_ERR 0x0080	發生線路狀態錯誤。線路狀態錯誤為 CE_FRAME、CE_OVERRUN 與CE_RXPARITY。
EV_RING 0x0100	偵測到振鈴指示器。
EV_RLSD 0x0020	接收線路訊號檢測 (receive-line-signal-detect, RLSD ) 訊號狀態改變。
EV_RXCHAR 0x0001	字元已接收且置於輸入緩衝區。
EV_RXFLAG 0x0002	事件字元已接收且置於輸入緩衝區，事件字元在裝置的 DCB 結構中指定，其使用 KsSetCommState 套用至串聯埠。
EV_TXEMPTY 0x0004	輸出緩衝區的最後一個字元已傳送。

回傳值

若函式執行成功將回傳 TRUE；失敗將回傳 FALSE。欲獲取延伸錯誤資訊請呼叫 GetLastError。

備註

KsSetCommMask 函式指定一組事件，用來監視特定的通訊資源。可在呼叫 KsWaitCommEvent 函式中指定通訊資源的處置，等待其一事件發生，欲獲得當前的通訊資源的事件遮罩，請使用 KsGetCommMask 函式。

範例

N/A

使用需求

參見