Structure SERIALKEYSA (winuser.h)

  • Article

Contient des informations sur la fonctionnalité d’accessibilité SerialKeys, qui interprète les données d’une aide de communication attachée à un port série en tant que commandes entraînant la simulation du clavier et de l’entrée de la souris par le système.

Syntaxe

typedef struct tagSERIALKEYSA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszActivePort;
  LPSTR lpszPort;
  UINT  iBaudRate;
  UINT  iPortState;
  UINT  iActive;
} SERIALKEYSA, *LPSERIALKEYSA;

Membres

cbSize

Type : UINT

Spécifie la taille de la structure, en octets.

dwFlags

Type : DWORD

Spécifie une combinaison des valeurs suivantes :

Valeur Signification
SERKF_AVAILABLE
0x00000002
 La fonctionnalité SerialKeys est disponible.
SERKF_INDICATOR
0x00000004
 Un indicateur visuel s’affiche lorsque la fonctionnalité SerialKeys est activée. Cette valeur n’est actuellement pas utilisée et est ignorée.
SERKF_SERIALKEYSON
0x00000001
 La fonctionnalité SerialKeys est activée.

lpszActivePort

Type : LPSTR

Pointe vers une chaîne qui contient le nom du port série qui reçoit l’entrée de l’aide de communication lorsque la fonctionnalité SerialKeys est activée. Si aucun port n’est utilisé, ce membre est NULL. Si ce membre est « Auto », le système surveille tous les ports série inutilisés pour l’entrée des aides de communication.

lpszPort

Type : LPSTR

Réservé; doit être NULL .

iBaudRate

Type : UINT

Spécifie le paramètre de taux de baud pour le port série spécifié par le membre lpszActivePort . Ce membre doit être défini sur l’une des valeurs CBR_ définies dans le fichier d’en-tête winbase.h. Si lpszActivePort est NULL, ce membre est égal à zéro.

iPortState

Type : UINT

Spécifie l’état du port spécifié par le membre lpszActivePort. Si lpszActivePort est NULL, iPortState est égal à zéro ; sinon, il s’agit de l’une des valeurs suivantes :

Valeur Signification
0
 Toutes les entrées sur ce port sont ignorées par la fonctionnalité SerialKeys.
1
 L’entrée sur ce port est surveillée pour les séquences d’activation SerialKeys lorsqu’aucune autre application n’a le port ouvert.
2
 Toutes les entrées sur ce port sont traitées comme des commandes SerialKeys.

iActive

Type : UINT

Spécifie le port actif.

Remarques

Une application utilise cette structure lors de l’appel de la fonction SystemParametersInfo avec la valeur SPI_GETSERIALKEYS ou SPI_SETSERIALKEYS. Lorsque vous utilisez SPI_GETSERIALKEYS, une application doit spécifier les membres cbSize, lpszActivePortet membres lpszPort de la structure SERIALKEYS  ; la fonction SystemParametersInfo remplit les membres restants. Une application doit spécifier tous les membres de structure lors de l’utilisation de la valeur SPI_SETSERIALKEYS.

Note

L’en-tête winuser.h définit SERIALKEYS 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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
d’en-tête winuser.h (include Windows.h)

Voir aussi

structures d’accessibilité

SystemParametersInfo