GetCommModemStatus, fonction (winbase.h)

Récupère les valeurs control-register du modem.

Syntaxe

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

Paramètres

[in] hFile

Handle de l’appareil de communication. La fonction CreateFile retourne ce handle.

[out] lpModemStat

Pointeur vers une variable qui reçoit l’état actuel des valeurs de registre de contrôle du modem. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
MS_CTS_ON 0x0010	Le signal CTS (clear-to-send) est activé.
MS_DSR_ON 0x0020	Le signal DSR (data-set-ready) est activé.
MS_RING_ON 0x0040	Le signal d’indicateur d’anneau est activé.
MS_RLSD_ON 0x0080	Le signal RLSD (receive-line-signal-detect) est activé.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetCommModemStatus est utile lorsque vous utilisez la fonction WaitCommEvent pour surveiller les signaux d’indicateur CTS, RLSD, DSR ou sonnerie. Pour détecter quand ces signaux changent d’état, utilisez WaitCommEvent , puis getCommModemStatus pour déterminer l’état après une modification.

La fonction échoue si le matériel ne prend pas en charge les valeurs control-register.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de communication

Ressources de communication

CreateFile

WaitCommEvent