Estrutura SERIALKEYSA (winuser.h)

  • Artigo

Contém informações sobre o recurso de acessibilidade SerialKeys, que interpreta dados de um auxílio de comunicação anexado a uma porta serial como comandos que fazem com que o sistema simule a entrada de teclado e mouse.

Sintaxe

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

Membros

cbSize

Tipo: UINT

Especifica o tamanho da estrutura, em bytes.

dwFlags

Tipo: DWORD

Especifica uma combinação dos seguintes valores:

Valor Significado
SERKF_AVAILABLE
0x00000002
 O recurso SerialKeys está disponível.
SERKF_INDICATOR
0x00000004
 Um indicador visual é exibido quando o recurso SerialKeys está ativado. Esse valor não é usado no momento e é ignorado.
SERKF_SERIALKEYSON
0x00000001
 O recurso SerialKeys está ativado.

lpszActivePort

Tipo: LPSTR

Aponta para uma cadeia de caracteres que contém o nome da porta serial que recebe a entrada do auxílio de comunicação quando o recurso SerialKeys está ativado. Se nenhuma porta estiver sendo usada, esse membro será NULL. Se esse membro for "Automático", o sistema observará todas as portas serial não usadas para entrada de auxílios de comunicação.

lpszPort

Tipo: LPSTR

Reservados; deve ser NULL.

iBaudRate

Tipo: UINT

Especifica a configuração de taxa de baud para a porta serial especificada pelo membro lpszActivePort . Esse membro deve ser definido como um dos valores de CBR_ definidos no arquivo de cabeçalho winbase.h. Se lpszActivePort for NULL, esse membro será zero.

iPortState

Tipo: UINT

Especifica o estado da porta especificada pelo membro lpszActivePort . Se lpszActivePort for NULL, iPortState será zero; caso contrário, ele é um dos seguintes valores:

Valor Significado
0
 Toda a entrada nessa porta é ignorada pelo recurso SerialKeys.
1
 A entrada nessa porta é observada para sequências de ativação serialkeys quando nenhum outro aplicativo tem a porta aberta.
2
 Todas as entradas nessa porta são tratadas como comandos SerialKeys.

iActive

Tipo: UINT

Especifica a porta ativa.

Comentários

Um aplicativo usa essa estrutura ao chamar a função SystemParametersInfo com o valor SPI_GETSERIALKEYS ou SPI_SETSERIALKEYS . Ao usar SPI_GETSERIALKEYS, um aplicativo deve especificar os membros cbSize, lpszActivePort e lpszPort da estrutura SERIALKEYS ; a função SystemParametersInfo preenche os membros restantes. Um aplicativo deve especificar todos os membros da estrutura ao usar o valor SPI_SETSERIALKEYS .

Observação

O cabeçalho winuser.h define SERIALKEYS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho winuser.h (inclua Windows.h)

Confira também

Estruturas de acessibilidade

SystemParametersInfo