RegisterRawInputDevices, fonction (winuser.h)

Inscrit les appareils 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. Le pointeur doit être aligné sur une limite DWORD (32 bits).

[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 brutes à l’aide de RegisterRawInputDevices. Par défaut, une application ne reçoit pas d’entrée brute.

Pour recevoir des messages WM_INPUT_DEVICE_CHANGE , une application doit spécifier l’indicateur 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 de l’appareil d’entrée brute.

Si une structure RAWINPUTDEVICE a le jeu d’indicateurs RIDEV_REMOVE et que le paramètre hwndTarget n’est pas défini sur NULL, la validation des paramètres échoue.

Une seule fenêtre par classe d’appareil d’entrée brute peut être inscrite pour recevoir une entrée brute dans un processus (la fenêtre transmise lors du dernier appel à RegisterRawInputDevices). En raison de cela, 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.

Spécifications

Voir aussi

conceptuelle

RAWINPUTDEVICE

d’entrée brute

Référence

WM_INPUT