SetCommMask 函式 (winbase.h)
指定要監視通訊裝置的事件集。
語法
BOOL SetCommMask(
[in] HANDLE hFile,
[in] DWORD dwEvtMask
);
參數
[in] hFile
通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。
[in] dwEvtMask
要啟用的事件。 值為零會停用所有事件。 此參數可以是下列一或多個值。
| 值 | 意義 |
|---|---|
|
在輸入時偵測到中斷。 |
|
CTS (清除傳送) 訊號已變更狀態。 |
|
DSR (數據集就緒) 訊號變更狀態。 |
|
發生行狀態錯誤。 行狀態錯誤CE_FRAME、CE_OVERRUN和CE_RXPARITY。 |
|
偵測到鈴聲指示器 (Indicator)。 |
|
RLSD (receive-line-signal-detect) 訊號已變更狀態。 |
|
會接收字元並放到輸入緩衝區。 |
|
已接收事件字元，並將其放在輸入緩衝區中。 事件字元是在裝置的 DCB 結構中指定，它會使用 ScommState 函式套用至序列埠。 |
|
輸出緩衝區中的最後一個字元已傳送。 |
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
SetCommMask 函式會指定可監視特定通訊資源的事件集。 通訊資源的句柄可以在 WaitCommEvent 函式的呼叫中指定，以等候其中一個事件發生。 若要取得通訊資源的目前事件遮罩，請使用 GetCommMask 函式。
範例
如需範例，請參閱 監視通訊事件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |