GetRawInputData, fonction (winuser.h)

Article
03/06/2024

Récupère l’entrée brute de l’appareil spécifié.

Syntaxe

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

Paramètres

[in] hRawInput

Type : HRAWINPUT

Handle de la structure RAWINPUT . Cela provient de l’élément lParam dans WM_INPUT.

[in] uiCommand

Type : UINT

Indicateur de commande. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
RID_HEADER 0x10000005	Obtenez les informations d’en-tête à partir de la structure RAWINPUT .
RID_INPUT 0x10000003	Obtenez les données brutes à partir de la structure RAWINPUT .

[out, optional] pData

Type : LPVOID

Pointeur vers les données qui proviennent de la structure RAWINPUT . Cela dépend de la valeur de uiCommand. Si pData a la valeur NULL, la taille requise de la mémoire tampon est retournée dans *pcbSize.

[in, out] pcbSize

Type : PUINT

Taille, en octets, des données dans pData.

[in] cbSizeHeader

Type : UINT

Taille, en octets, de la structure RAWINPUTHEADER .

Valeur retournée

Type : UINT

Si pData a la valeur NULL et que la fonction réussit, la valeur de retour est 0. Si pData n’est pas NULL et que la fonction réussit, la valeur de retour est le nombre d’octets copiés dans pData.

En cas d’erreur, la valeur de retour est (UINT)-1.

Remarques

GetRawInputData obtient l’entrée brute une structure RAWINPUT à la fois. En revanche, GetRawInputBuffer obtient un tableau de structures RAWINPUT .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-rawinput-l1-1-0 (introduit dans Windows 10, version 10.0.14393)