Função GetRawInputDeviceInfoA (winuser.h)

Artigo
08/27/2023

Recupera informações sobre o dispositivo de entrada bruta.

Sintaxe

UINT GetRawInputDeviceInfoA(
  [in, optional]      HANDLE hDevice,
  [in]                UINT   uiCommand,
  [in, out, optional] LPVOID pData,
  [in, out]           PUINT  pcbSize
);

Parâmetros

[in, optional] hDevice

Tipo: HANDLE

Um identificador para o dispositivo de entrada bruta. Isso vem do membro hDevice de RAWINPUTHEADER ou de GetRawInputDeviceList.

[in] uiCommand

Tipo: UINT

Especifica quais dados serão retornados no pData. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
RIDI_PREPARSEDDATA 0x20000005	pData é um ponteiro PHIDP_PREPARSED_DATA para um buffer para os dados pré-preparados de uma coleção de nível superior.
RIDI_DEVICENAME 0x20000007	pData aponta para uma cadeia de caracteres que contém o nome da interface do dispositivo. Se este dispositivo for aberto com o Modo de Acesso Compartilhado , você poderá chamar CreateFile com esse nome para abrir uma coleção HID e usar o identificador retornado para chamar ReadFile para ler relatórios de entrada e WriteFile para enviar relatórios de saída. Para obter mais informações, consulte Abrindo coleções HID e tratando relatórios HID. Somente para esse uiCommand , o valor em pcbSize é a contagem de caracteres (não a contagem de bytes).
RIDI_DEVICEINFO 0x2000000b	pData aponta para uma estrutura de RID_DEVICE_INFO .

Valor

Significado

RIDI_PREPARSEDDATA
0x20000005

pData é um ponteiro PHIDP_PREPARSED_DATA para um buffer para os dados pré-preparados de uma coleção de nível superior.

RIDI_DEVICENAME
0x20000007

pData aponta para uma cadeia de caracteres que contém o nome da interface do dispositivo.

Se este dispositivo for aberto com o Modo de Acesso Compartilhado , você poderá chamar CreateFile com esse nome para abrir uma coleção HID e usar o identificador retornado para chamar ReadFile para ler relatórios de entrada e WriteFile para enviar relatórios de saída.

Para obter mais informações, consulte Abrindo coleções HID e tratando relatórios HID.

Somente para esse uiCommand , o valor em pcbSize é a contagem de caracteres (não a contagem de bytes).

RIDI_DEVICEINFO
0x2000000b

pData aponta para uma estrutura de RID_DEVICE_INFO .

[in, out, optional] pData

Tipo: LPVOID

Um ponteiro para um buffer que contém as informações especificadas por uiCommand.

Se uiCommand for RIDI_DEVICEINFO, defina o membro cbSize de RID_DEVICE_INFO como sizeof(RID_DEVICE_INFO) antes de chamar GetRawInputDeviceInfo.

[in, out] pcbSize

Tipo: PUINT

O tamanho, em bytes, dos dados em pData.

Retornar valor

Tipo: UINT

Se tiver êxito, essa função retornará um número não negativo indicando o número de bytes copiados para pData.

Se pData não for grande o suficiente para os dados, a função retornará -1. Se pData for NULL, a função retornará um valor igual a zero. Em ambos os casos, pcbSize é definido como o tamanho mínimo necessário para o buffer pData .

Chame GetLastError para identificar outros erros.

Comentários

Observação

O cabeçalho winuser.h define GetRawInputDeviceInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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)