Partager via


GetCommProperties, fonction (winbase.h)

Récupère des informations sur les propriétés de communication d’un appareil de communication spécifié.

Syntaxe

BOOL GetCommProperties(
  [in]  HANDLE     hFile,
  [out] LPCOMMPROP lpCommProp
);

Paramètres

[in] hFile

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

[out] lpCommProp

Pointeur vers une structure COMMPROP dans laquelle les informations des propriétés de communication sont retournées. Ces informations peuvent être utilisées dans les appels suivants à la fonction SetCommState, SetCommTimeouts ou SetupComm pour configurer l’appareil de communication.

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 GetCommProperties retourne des informations d’un pilote de périphérique sur les paramètres de configuration pris en charge par le pilote.

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

COMMPROP

Fonctions de communication

Ressources de communication

CreateFile

SetCommState

SetCommTimeouts

SetupComm