Compartilhar via


Função GetRegisteredRawInputDevices (winuser.h)

Recupera as informações sobre os dispositivos de entrada brutos para o aplicativo atual.

Sintaxe

UINT GetRegisteredRawInputDevices(
  [out, optional] PRAWINPUTDEVICE pRawInputDevices,
  [in, out]       PUINT           puiNumDevices,
  [in]            UINT            cbSize
);

Parâmetros

[out, optional] pRawInputDevices

Tipo: PRAWINPUTDEVICE

Uma matriz de estruturas RAWINPUTDEVICE para o aplicativo.

[in, out] puiNumDevices

Tipo: PUINT

O número de estruturas RAWINPUTDEVICE em *pRawInputDevices.

[in] cbSize

Tipo: UINT

O tamanho, em bytes, de uma estrutura RAWINPUTDEVICE .

Retornar valor

Tipo: UINT

Se tiver êxito, a função retornará um número não negativo que é o número de estruturas RAWINPUTDEVICE gravadas no buffer.

Se o buffer pRawInputDevices for muito pequeno ou NULL, a função definirá o último erro como ERROR_INSUFFICIENT_BUFFER, retornará -1 e definirá puiNumDevices para o número necessário de dispositivos. Se a função falhar por qualquer outro motivo, ela retornará -1. Para obter mais detalhes, chame GetLastError.

Comentários

Para receber entrada bruta de um dispositivo, um aplicativo deve registrá-lo usando RegisterRawInputDevices.

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

Confira também

Conceitual

RAWINPUTDEVICE

Dados brutos

Referência

RegisterRawInputDevices