Alocação de IDs winEvent

Cada WinEvent destina-se a ser usado apenas para uma finalidade específica. O uso de um WinEvent para uma finalidade não intencional pode causar colisões com outros aplicativos ou o sistema operacional, o que pode fazer com que os aplicativos ou o sistema operacional se tornem instáveis.

A Microsoft definiu várias categorias diferentes de WinEvents e, para cada categoria, definiu um ou mais intervalos de valores para uso como IDs winEvent. O intervalo Reservado à Comunidade (0xA000 — 0xAFFF) está disponível para aplicativos que precisam definir novos WinEvents. O uso de valores desse intervalo ajuda a reduzir o risco de colisões; no entanto, os desenvolvedores que criam novos WinEvents ainda precisam colaborar para evitar colisões entre seus aplicativos.

A tabela a seguir mostra as categorias WinEvent e os intervalos de valores definidos para cada categoria.

Categoria	Intervalo	Atualmente em uso	Comentários
Eventos de Acessibilidade Ativa da Microsoft (Sistema Reservado)	0x00FF 0x0001	0x0001-0x0020	IDs de evento EVENT_SYSTEM_*
Eventos de Acessibilidade Ativa da Microsoft (Sistema Reservado)	0x40FF 0x4001	0x4001-0x4007	IDs de evento EVENT_CONSOLE_*
eventos Automação da Interface do Usuário (Sistema Reservado)	0x4E00-0x4EFF	0x4E20-0x4E33	Automação da Interface do Usuário IDs de evento
eventos Automação da Interface do Usuário (Sistema Reservado)	0x7500-0x75FF	0x759B 0x7530	Automação da Interface do Usuário IDs de evento alteradas por propriedade
Eventos de Acessibilidade Ativa da Microsoft (Sistema Reservado)	0x8000-0x80FF	0x8000-0x8015	IDs de evento EVENT_OBJECT_*
OEM Reservado	0x0101-0x01FF	0x0101-0x0122	IDs de evento IAccessible2
Comunidade Reservada	0xA000-0xAFFF	Nenhum	Reservado para novos eventos definidos pelas especificações da AIA (Accessibility Interoperability Alliance)
ATOM	0xC000-0xFFFF	0xC000-0xFFFF	Reservado para eventos personalizados alocados no runtime

 

Os tópicos a seguir descrevem os intervalos WinEvent com mais detalhes.

Microsoft Active Accessibility and Automação da Interface do Usuário Events

Cinco intervalos de IDs winEvent são reservados para uso pelo Microsoft Active Accessibility e microsoft Automação da Interface do Usuário. O primeiro intervalo (0x0001 — 0x00FF) é reservado para eventos no nível do sistema, normalmente usados para descrever situações que afetam todos os aplicativos no sistema. O segundo intervalo (0x4001 — 0x40FF) é reservado para eventos específicos do console do Windows. O terceiro (0x4E00 — 0x4EFF) e os quatro intervalos (0x7500— 0x75FF) são para o reflexo de eventos de Automação da Interface do Usuário. Por fim, o quinto intervalo (0x8000 — 0x80FF) é para eventos no nível do objeto que pertencem a situações específicas de objetos dentro de um aplicativo.

Todos os eventos de Acessibilidade Ativa da Microsoft e Automação da Interface do Usuário são definidos nos arquivos de cabeçalho WinUser.h e UIAutomationClient.h.

Eventos reservados do OEM

O intervalo reservado OEM está aberto para qualquer pessoa que precise usar WinEvents como um mecanismo de comunicação. Os desenvolvedores devem definir e publicar definições de evento junto com seus parâmetros (ou também com tipos de objeto associados) para processamento de eventos para que colisões acidentais de IDs de evento possam ser evitadas. A especificação IAccessible2 usa parte do intervalo reservado do OEM.

Eventos reservados da comunidade

O intervalo Reservado à Comunidade é para WinEvents especificado pela AIA (Accessibility Interoperability Alliance) para uso em todo o setor. Os desenvolvedores são altamente incentivados a definir e publicar uma especificação oficial antes de usar valores desse intervalo.

Eventos ATOM

O intervalo ATOM é reservado para IDs de evento alocadas em runtime por meio da API de extensibilidade Automação da Interface do Usuário. Não use os valores do intervalo ATOM para qualquer outra finalidade. Usar a função GlobalAddAtom com um GUID de cadeia de caracteres é o método recomendado para alocar WinEvents do intervalo ATOM.

Usando valores de um intervalo reservado

De acordo com a especificação WinEvent, os valores do intervalo Reservado do Sistema ou de qualquer outro intervalo não definido não podem ser usados sem revisar o SDK. Para novos WinEvents, os aplicativos devem usar valores dos intervalos OEM Reservado ou Reservado à Comunidade. Antes de usar um novo WinEvent, os desenvolvedores são altamente aconselhados a compartilhar suas especificações de forma aberta e ampla e devem trabalhar com a Accessibility Interoperability Alliance para definir as especificações do WinEvent.

Tópicos relacionados

WinEvents

Aliança de Interoperabilidade de Acessibilidade