EscapeCommFunction, fonction (winbase.h)

Indique au périphérique de communication spécifié d’effectuer une fonction étendue.

Syntaxe

BOOL EscapeCommFunction(
  [in] HANDLE hFile,
  [in] DWORD  dwFunc
);

Paramètres

[in] hFile

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

[in] dwFunc

Fonction étendue à exécuter. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
CLRBREAK
9
Restaure la transmission de caractères et place la ligne de transmission dans un état sans saut. Le code de la fonction étendue CLRBREAK est identique à la fonction ClearCommBreak .
CLRDTR
6
Efface le signal DTR (data-terminal-ready).
CLRRTS
4
Efface le signal RTS (request-to-send).
SETBREAK
8
Suspend la transmission de caractères et place la ligne de transmission dans un état d’arrêt jusqu’à ce que la fonction ClearCommBreak soit appelée (ou EscapeCommFunction est appelée avec le code de la fonction étendue CLRBREAK). Le code de la fonction étendue SETBREAK est identique à la fonction SetCommBreak . Notez que cette fonction étendue ne vide pas les données qui n’ont pas été transmises.
SETDTR
5
Envoie le signal DTR (data-terminal-ready).
SETRTS
3
Envoie le signal RTS (request-to-send).
SETXOFF
1
Provoque la transmission comme si un caractère XOFF avait été reçu.
SETXON
2
Provoque la transmission comme si un caractère XON avait été reçu.

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.

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

ClearCommBreak

Fonctions de communication

Ressources de communication

CreateFile

SetCommBreak