RegisterRawInputDevices, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Référence