共用方式為


GetCommModemStatus 函式 (winbase.h)

擷取數據機控制緩存器值。

語法

BOOL GetCommModemStatus(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpModemStat
);

參數

[in] hFile

通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。

[out] lpModemStat

接收數據機控制緩存器值目前狀態之變數的指標。 此參數可以是下列一或多個值。

意義
MS_CTS_ON
0x0010
CTS (清除傳送) 訊號已開啟。
MS_DSR_ON
0x0020
DSR (數據集就緒) 訊號已開啟。
MS_RING_ON
0x0040
環形指標訊號已開啟。
MS_RLSD_ON
0x0080
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

另請參閱

通訊函式

通訊資源

CreateFile

WaitCommEvent