GetCommConfig, fonction (winbase.h)

  • Article

Récupère la configuration actuelle d’un appareil de communication.

Pour récupérer les paramètres de configuration par défaut à partir du gestionnaire de périphériques, utilisez la fonction GetDefaultCommConfig .

Syntaxe

BOOL GetCommConfig(
  [in]      HANDLE       hCommDev,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

Paramètres

[in] hCommDev

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

[out] lpCC

Pointeur vers une mémoire tampon qui reçoit une structure COMMCONFIG .

[in, out] lpdwSize

Taille, en octets, de la mémoire tampon pointée par lpCC. Lorsque la fonction retourne, la variable contient le nombre d’octets copiés si la fonction réussit, ou le nombre d’octets requis si la mémoire tampon était trop petite.

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’erreur étendues, utilisez la fonction 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

COMMCONFIG

Fonctions de communication

Ressources de communication

CreateFile

GetDefaultCommConfig

SetCommConfig