Funzione GetCommModemStatus (winbase.h)

Recupera i valori del registro di controllo del modem.

Sintassi

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

Parametri

[in] hFile

Handle per il dispositivo di comunicazione. La funzione CreateFile restituisce questo handle.

[out] lpModemStat

Puntatore a una variabile che riceve lo stato corrente dei valori del registro di controllo modem. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
MS_CTS_ON 0x0010	Il segnale CTS (clear-to-send) è attivo.
MS_DSR_ON 0x0020	Il segnale DSR (data-set-ready) è attivo.
MS_RING_ON 0x0040	Il segnale dell'indicatore dell'anello è attivo.
MS_RLSD_ON 0x0080	Il segnale RLSD (receive-line-signal-detect) è attivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetCommModemStatus è utile quando si usa la funzione WaitCommEvent per monitorare i segnali dell'indicatore CTS, RLSD, DSR o anello. Per rilevare quando questi segnali cambiano stato, usare WaitCommEvent e quindi usare GetCommModemStatus per determinare lo stato dopo che si verifica una modifica.

La funzione ha esito negativo se l'hardware non supporta i valori del registro di controllo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni di comunicazione

Risorse di comunicazione

CreateFile

WaitCommEvent