Structure COMMCONFIG (winbase.h)

Article
03/03/2024

Contient des informations sur l’état de configuration d’un appareil de communication.

Syntaxe

typedef struct _COMMCONFIG {
  DWORD dwSize;
  WORD  wVersion;
  WORD  wReserved;
  DCB   dcb;
  DWORD dwProviderSubType;
  DWORD dwProviderOffset;
  DWORD dwProviderSize;
  WCHAR wcProviderData[1];
} COMMCONFIG, *LPCOMMCONFIG;

Membres

dwSize

Taille de la structure, en octets. L’appelant doit définir ce membre sur sizeof(COMMCONFIG).

wVersion

Numéro de version de la structure. Ce paramètre peut être 1. La version de la structure spécifique au fournisseur doit être incluse dans le membre wcProviderData .

wReserved

Réservé ; ne pas utiliser.

dcb

Structure de bloc de contrôle d’appareil (DCB) pour les appareils série RS-232. Une structure DCB est toujours présente quel que soit le sous-type de pilote de port spécifié dans la structure COMMPROP de l’appareil.

dwProviderSubType

Type de fournisseur de communications, et donc format des données spécifiques au fournisseur. Pour obtenir la liste des types de fournisseurs de communications, consultez la description de la structure COMMPROP .

dwProviderOffset

Décalage des données spécifiques au fournisseur par rapport au début de la structure, en octets. Ce membre est égal à zéro s’il n’existe aucune donnée spécifique au fournisseur.

dwProviderSize

Taille des données spécifiques au fournisseur, en octets.

wcProviderData[1]

Données facultatives spécifiques au fournisseur. Ce membre peut être de n’importe quelle taille ou être omis. Étant donné que la structure COMMCONFIG peut être développée à l’avenir, les applications doivent utiliser le membre dwProviderOffset pour déterminer l’emplacement de ce membre.

Remarques

Si le sous-type de fournisseur est PST_RS232 ou PST_PARALLELPORT, le membre wcProviderData est omis. Si le sous-type de fournisseur est PST_MODEM, le membre wcProviderData contient une structure MODEMSETTINGS .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	winbase.h (inclure Windows.h)

Voir aussi