GetCommModemStatus, fonction (winbase.h)

  • Article

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