RegisterRawInputDevices, fonction (winuser.h)

Article
08/27/2023

Inscrit les périphériques qui fournissent les données d’entrée brutes.

Syntaxe

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

Paramètres

[in] pRawInputDevices

Type : PCRAWINPUTDEVICE

Tableau de structures RAWINPUTDEVICE qui représentent les appareils qui fournissent l’entrée brute.

[in] uiNumDevices

Type : UINT

Nombre de structures RAWINPUTDEVICE pointées par pRawInputDevices.

[in] cbSize

Type : UINT

Taille, en octets, d’une structure RAWINPUTDEVICE .

Valeur retournée

Type : BOOL

TRUE si la fonction réussit ; sinon, FALSE. Si la fonction échoue, appelez GetLastError pour plus d’informations.

Remarques

Pour recevoir des messages WM_INPUT , une application doit d’abord inscrire les périphériques d’entrée brute à l’aide de RegisterRawInputDevices. Par défaut, une application ne reçoit pas d’entrée brute.

Pour recevoir WM_INPUT_DEVICE_CHANGE messages, une application doit spécifier l’indicateur de RIDEV_DEVNOTIFY pour chaque classe d’appareil spécifiée par les champs usUsagePage et usUsage de la structure RAWINPUTDEVICE . Par défaut, une application ne reçoit pas de notifications WM_INPUT_DEVICE_CHANGE pour l’arrivée et la suppression d’un appareil d’entrée brute.

Si une structure RAWINPUTDEVICE a l’indicateur RIDEV_REMOVE défini et que le paramètre hwndTarget n’est pas défini sur NULL, la validation du paramètre échoue.

Une seule fenêtre par classe de périphérique d’entrée brute peut être inscrite pour recevoir une entrée brute dans un processus (la fenêtre passée lors du dernier appel à RegisterRawInputDevices). Pour cette raison, RegisterRawInputDevices ne doit pas être utilisé à partir d’une bibliothèque, car il peut interférer avec toute logique de traitement d’entrée brute déjà présente dans les applications qui le chargent.

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)