Função GetRawInputDeviceInfoA (winuser.h)
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 |
---|---|
|
pData é um ponteiro PHIDP_PREPARSED_DATA para um buffer para os dados pré-preparadosde uma coleção de nível superior. |
|
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). |
|
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) |
Confira também
Conceitual
Referência
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de