Função RegisterRawInputDevices (winuser.h)

Registra os dispositivos que fornecem os dados de entrada 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. O ponteiro deve ser alinhado em um limite DWORD (32 bits).

[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 .

Valor de retorno

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.

Observações

Para receber mensagens WM_INPUT , 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 notificações de WM_INPUT_DEVICE_CHANGE para a chegada e remoção do 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 em 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

Consulte também

Conceitual

RAWINPUTDEVICE

de Entrada Bruta

Referência

WM_INPUT