Función GetRawInputData (winuser.h)

Artículo
03/13/2024

Recupera la entrada sin procesar del dispositivo especificado.

Sintaxis

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

Identificador de la estructura RAWINPUT . Esto procede de lParam en WM_INPUT.

[in] uiCommand

Tipo: UINT

Marca de comando. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
RID_HEADER 0x10000005	Obtenga la información de encabezado de la estructura RAWINPUT .
RID_INPUT 0x10000003	Obtenga los datos sin procesar de la estructura RAWINPUT .

[out, optional] pData

Tipo: LPVOID

Puntero a los datos que proceden de la estructura RAWINPUT . Esto depende del valor de uiCommand. Si pData es NULL, el tamaño necesario del búfer se devuelve en *pcbSize.

[in, out] pcbSize

Tipo: PUINT

Tamaño, en bytes, de los datos de pData.

[in] cbSizeHeader

Tipo: UINT

Tamaño, en bytes, de la estructura RAWINPUTHEADER .

Valor devuelto

Tipo: UINT

Si pData es NULL y la función se ejecuta correctamente, el valor devuelto es 0. Si pData no es NULL y la función se ejecuta correctamente, el valor devuelto es el número de bytes copiados en pData.

Si se produce un error, el valor devuelto es (UINT)-1.

Comentarios

GetRawInputData obtiene la entrada sin procesar una estructura RAWINPUT a la vez. Por el contrario, GetRawInputBuffer obtiene una matriz de estructuras RAWINPUT .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-rawinput-l1-1-0 (introducido en Windows 10, versión 10.0.14393)