Funzione GetRawInputData (winuser.h)

Articolo
03/13/2024

Recupera l'input non elaborato dal dispositivo specificato.

Sintassi

UINT GetRawInputData(
  [in]            HRAWINPUT hRawInput,
  [in]            UINT      uiCommand,
  [out, optional] LPVOID    pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

Parametri

[in] hRawInput

Tipo: HRAWINPUT

Handle alla struttura RAWINPUT . Questo proviene dall'lParam in WM_INPUT.

[in] uiCommand

Tipo: UINT

Flag di comando. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
RID_HEADER 0x10000005	Ottenere le informazioni sull'intestazione dalla struttura RAWINPUT .
RID_INPUT 0x10000003	Ottenere i dati non elaborati dalla struttura RAWINPUT .

[out, optional] pData

Tipo: LPVOID

Puntatore ai dati provenienti dalla struttura RAWINPUT . Ciò dipende dal valore di uiCommand. Se pData è NULL, le dimensioni necessarie del buffer vengono restituite in *pcbSize.

[in, out] pcbSize

Tipo: PUINT

Dimensioni, in byte, dei dati in pData.

[in] cbSizeHeader

Tipo: UINT

Dimensioni, in byte, della struttura RAWINPUTHEADER .

Valore restituito

Tipo: UINT

Se pData è NULL e la funzione ha esito positivo, il valore restituito è 0. Se pData non è NULL e la funzione ha esito positivo, il valore restituito è il numero di byte copiati in pData.

Se si verifica un errore, il valore restituito è (UINT)-1.

Commenti

GetRawInputData ottiene l'input non elaborato una struttura RAWINPUT alla volta. Al contrario, GetRawInputBuffer ottiene una matrice di strutture RAWINPUT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-rawinput-l1-1-0 (introdotta in Windows 10, versione 10.0.14393)