Compartilhar via


Função GetRawInputData (winuser.h)

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

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

de Entrada Bruta

Referência