Função RegisterRawInputDevices (winuser.h)

Artigo
08/27/2023

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

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-rawinput-l1-1-0 (introduzido no Windows 10, versão 10.0.14393)