Share via

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