BuildCommDCBAndTimeoutsA, fonction (winbase.h)
Convertit une chaîne de définition d’appareil en codes de bloc de contrôle d’appareil appropriés et les place dans un bloc de contrôle d’appareil. La fonction peut également configurer des valeurs de délai d’attente, y compris la possibilité d’absence de délai d’attente, pour un appareil ; Le comportement de la fonction à cet égard dépend du contenu de la chaîne de définition d’appareil.
Syntaxe
BOOL BuildCommDCBAndTimeoutsA(
[in] LPCSTR lpDef,
[out] LPDCB lpDCB,
[out] LPCOMMTIMEOUTS lpCommTimeouts
);
Paramètres
[in] lpDef
Informations sur le contrôle de l’appareil. La fonction accepte cette chaîne, l’analyse, puis définit les valeurs appropriées dans la structure DCB pointée par lpDCB.
La chaîne doit avoir le même formulaire que le mode arguments de ligne de commande de la commande :
La sous-chaîne « baud » peut être l’une des valeurs répertoriées, qui sont en paires. Les valeurs à deux chiffres sont les deux premiers chiffres des valeurs associées qu’elles représentent. Par exemple, 11 représente 110 bauds, 19 représente 19 200 bauds.
La sous-chaîne « parité » indique comment le bit de parité est utilisé pour détecter les erreurs de transmission.
Les valeurs représentent « none », « even », « odd »,
« mark », et « space ».
Pour plus d’informations, consultez la référence de commande Mode dans TechNet.
Par exemple, la chaîne suivante spécifie un taux de baud de 1200, aucune parité, 8 bits de données et 1 bit d’arrêt :
baud=1200 parity=N data=8 stop=1
[out] lpDCB
Pointeur vers une structure de DCB
[out] lpCommTimeouts
Pointeur vers une structure COMMTIMEOUTS qui reçoit des informations de délai d’attente.
Valeur de retour
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, appelez GetLastError.
Remarques
La fonction BuildCommDCBAndTimeouts modifie son comportement de paramètre de délai d’attente en fonction de la présence ou de l’absence d’une sous-chaîne « to={on|off} » dans lpDef:
- Si cette chaîne contient la sous-chaîne « to=on », la fonction définit la WriteTotalTimeoutConstant membre du COMMTIMEOUTS structure sur 60000 et tous les autres membres sur 0.
- Si cette chaîne contient la sous-chaîne « to=off », la fonction définit les membres de COMMTIMEOUTS sur 0.
- Si cette chaîne ne spécifie pas de sous-chaîne « to={on|off} », la fonction ignore la structure COMMTIMEOUTS dans lpCommTimeouts.
Note
L’en-tête winbase.h définit BuildCommDCBAndTimeouts comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP |
| serveur minimum pris en charge | Windows Server 2003 |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |