Função RegisterRawInputDevices (winuser.h)

Registra os dispositivos que fornecem os dados brutos.

Sintaxe

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

Parâmetros

[in] pRawInputDevices

Tipo: PCRAWINPUTDEVICE

Uma matriz de estruturas RAWINPUTDEVICE que representam os dispositivos que fornecem a entrada bruta.

[in] uiNumDevices

Tipo: UINT

O número de estruturas RAWINPUTDEVICE apontadas por pRawInputDevices.

[in] cbSize

Tipo: UINT

O tamanho, em bytes, de uma estrutura RAWINPUTDEVICE .

Retornar valor

Tipo: BOOL

TRUE se a função for bem-sucedida; caso contrário, FALSE. Se a função falhar, chame GetLastError para obter mais informações.

Comentários

Para receber WM_INPUT mensagens, um aplicativo deve primeiro registrar os dispositivos de entrada brutos usando RegisterRawInputDevices. Por padrão, um aplicativo não recebe entrada bruta.

Para receber mensagens WM_INPUT_DEVICE_CHANGE , um aplicativo deve especificar o sinalizador RIDEV_DEVNOTIFY para cada classe de dispositivo especificada pelos campos usUsagePage e usUsage da estrutura RAWINPUTDEVICE . Por padrão, um aplicativo não recebe WM_INPUT_DEVICE_CHANGE notificações de chegada e remoção de dispositivo de entrada bruta.

Se uma estrutura RAWINPUTDEVICE tiver o sinalizador RIDEV_REMOVE definido e o parâmetro hwndTarget não estiver definido como NULL, a validação do parâmetro falhará.

Apenas uma janela por classe de dispositivo de entrada bruta pode ser registrada para receber entrada bruta dentro de um processo (a janela passada na última chamada para RegisterRawInputDevices). Por isso, RegisterRawInputDevices não deve ser usado de uma biblioteca, pois pode interferir em qualquer lógica de processamento de entrada bruta já presente em aplicativos que o carregam.

Requisitos

Confira também

Conceitual

RAWINPUTDEVICE

Dados brutos

Referência

WM_INPUT