Structure COMMPROP (winbase.h)
Contient des informations sur un pilote de communication.
Syntaxe
typedef struct _COMMPROP {
WORD wPacketLength;
WORD wPacketVersion;
DWORD dwServiceMask;
DWORD dwReserved1;
DWORD dwMaxTxQueue;
DWORD dwMaxRxQueue;
DWORD dwMaxBaud;
DWORD dwProvSubType;
DWORD dwProvCapabilities;
DWORD dwSettableParams;
DWORD dwSettableBaud;
WORD wSettableData;
WORD wSettableStopParity;
DWORD dwCurrentTxQueue;
DWORD dwCurrentRxQueue;
DWORD dwProvSpec1;
DWORD dwProvSpec2;
WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;
Membres
wPacketLength
Taille du paquet de données entier, quelle que soit la quantité de données demandée, en octets.
wPacketVersion
Version de la structure.
dwServiceMask
Masque de bits indiquant les services implémentés par ce fournisseur. La valeur SP_SERIALCOMM est toujours spécifiée pour les fournisseurs de communications, y compris les fournisseurs de modems.
dwReserved1
Réservé ; ne pas utiliser.
dwMaxTxQueue
Taille maximale de la mémoire tampon de sortie interne du pilote, en octets. La valeur zéro indique qu’aucune valeur maximale n’est imposée par le fournisseur série.
dwMaxRxQueue
Taille maximale de la mémoire tampon d’entrée interne du pilote, en octets. La valeur zéro indique qu’aucune valeur maximale n’est imposée par le fournisseur série.
dwMaxBaud
Débit maximal autorisé en bauds, en bits par seconde (bps). Ce membre peut être l’une des valeurs suivantes.
dwProvSubType
Type de fournisseur de communications.
dwProvCapabilities
Masque de bits indiquant les fonctionnalités offertes par le fournisseur. Ce membre peut être une combinaison des valeurs suivantes.
dwSettableParams
Masque de bits indiquant les paramètres de communication qui peuvent être modifiés. Ce membre peut être une combinaison des valeurs suivantes.
dwSettableBaud
Taux de bauds qui peuvent être utilisés. Pour connaître les valeurs, consultez le membre dwMaxBaud .
wSettableData
Masque de bits indiquant le nombre de bits de données pouvant être définis. Ce membre peut être une combinaison des valeurs suivantes.
wSettableStopParity
Masque de bits indiquant les paramètres de bit d’arrêt et de parité qui peuvent être sélectionnés. Ce membre peut être une combinaison des valeurs suivantes.
dwCurrentTxQueue
Taille de la mémoire tampon de sortie interne du pilote, en octets. La valeur zéro indique que la valeur n’est pas disponible.
dwCurrentRxQueue
Taille de la mémoire tampon d’entrée interne du pilote, en octets. La valeur zéro indique que la valeur n’est pas disponible.
dwProvSpec1
Toutes les données spécifiques au fournisseur. Les applications doivent ignorer ce membre, sauf si elles disposent d’informations détaillées sur le format des données requises par le fournisseur.
Définissez ce membre sur COMMPROP_INITIALIZED avant d’appeler la fonction GetCommProperties pour indiquer que le membre wPacketLength est déjà valide.
dwProvSpec2
Toutes les données spécifiques au fournisseur. Les applications doivent ignorer ce membre, sauf si elles disposent d’informations détaillées sur le format des données requises par le fournisseur.
wcProvChar[1]
Toutes les données spécifiques au fournisseur. Les applications doivent ignorer ce membre, sauf si elles disposent d’informations détaillées sur le format des données requises par le fournisseur.
Remarques
Le contenu des membres dwProvSpec1, dwProvSpec2 et wcProvChar dépend du sous-type de fournisseur (spécifié par le membre dwProvSubType ).
Si le sous-type de fournisseur est PST_MODEM, ces membres sont utilisés comme suit.
| Valeur | Signification |
|---|---|
| dwProvSpec1 | Non utilisé. |
| dwProvSpec2 | Non utilisé. |
| wcProvChar | Contient une structure MODEMDEVCAPS . |
Configuration requise
| Client minimal pris en charge | Windows XP |
| Serveur minimal pris en charge | Windows Server 2003 |
| En-tête | winbase.h (inclure Windows.h) |