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. O ponteiro deve ser alinhado em um limite DWORD (32 bits).

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

Valor de retorno

Tipo: UINT

Se bem-sucedida, 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.

Observações

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

Requisitos

Requisito Valor
Cliente mínimo suportado Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
de DLL User32.dll

Consulte também

Conceitual

RAWINPUTDEVICE

de Entrada Bruta

Referência

RegisterRawInputDevices