Função GetRawInputData (winuser.h)

Artigo
03/13/2024

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 usar um dos valores a seguir.

Valor	Significado
RID_HEADER 0x10000005	Obtenha as informações de cabeçalho da estrutura RAWINPUT .
RID_INPUT 0x10000003	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. 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 em pData.

[in] cbSizeHeader

Tipo: UINT

O tamanho, em bytes, da estrutura RAWINPUTHEADER .

Retornar valor

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.

Comentários

GetRawInputData obtém a entrada bruta uma estrutura RAWINPUT por vez. Por outro lado, GetRawInputBuffer obtém uma matriz de estruturas RAWINPUT .

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)