Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Recupera a entrada bruta do dispositivo especificado.
Sintaxe
UINT GetRawInputData(
[in] HRAWINPUT hRawInput,
[in] UINT uiCommand,
[out, optional] LPVOID pData,
[in, out] PUINT pcbSize,
[in] UINT cbSizeHeader
);
Parâmetros
[in] hRawInput
Tipo: HRAWINPUT
Um identificador para a estrutura RAWINPUT . Isso vem do lParam em WM_INPUT.
[in] uiCommand
Tipo: UINT
O sinalizador de comando. Esse parâmetro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Obtenha as informações de cabeçalho da estrutura RAWINPUT . |
|
Obtenha os dados brutos da estrutura RAWINPUT . |
[out, optional] pData
Tipo: LPVOID
Um ponteiro para os dados provenientes da estrutura RAWINPUT . Isso depende do valor de uiCommand. O ponteiro deve ser alinhado em um limite DWORD (32 bits).
Se pData for NULL, o tamanho necessário do buffer será retornado em *pcbSize.
[in, out] pcbSize
Tipo: PUINT
O tamanho, em bytes, dos dados no pData.
[in] cbSizeHeader
Tipo: UINT
O tamanho, em bytes, da estrutura RAWINPUTHEADER .
Valor de retorno
Tipo: UINT
Se pData for NULL e a função for bem-sucedida, o valor retornado será 0. Se pData não for NULL e a função for bem-sucedida, o valor retornado será o número de bytes copiados para pData.
Se houver um erro, o valor retornado será (UINT)-1.
Observações
GetRawInputData obtém a entrada bruta uma estrutura RAWINPUT de cada vez. Por outro lado, GetRawInputBuffer obtém uma matriz de estruturas RAWINPUT .
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 |
| conjunto de API | ext-ms-win-ntuser-rawinput-l1-1-0 (introduzido no Windows 10, versão 10.0.14393) |
Consulte também
Conceitual
Referência