GetCommModemStatus 函式 (winbase.h)
擷取數據機控制緩存器值。
語法
BOOL GetCommModemStatus(
[in] HANDLE hFile,
[out] LPDWORD lpModemStat
);
參數
[in] hFile
通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。
[out] lpModemStat
接收數據機控制緩存器值目前狀態之變數的指標。 此參數可以是下列一或多個值。
| 值 | 意義 |
|---|---|
|
CTS (清除傳送) 訊號已開啟。 |
|
DSR (數據集就緒) 訊號已開啟。 |
|
環形指標訊號已開啟。 |
|
RLSD (接收線路訊號偵測) 訊號已開啟。 |
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
當您使用 WaitCommEvent 函式來監視 CTS、RLSD、DSR 或環形指標訊號時，GetCommModemStatus 函式很有用。 若要偵測這些訊號變更狀態的時間，請使用 WaitCommEvent ，然後使用 GetCommModemStatus 來判斷變更發生之後的狀態。
如果硬體不支援 control-register 值，則函式會失敗。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |