Structure RAWINPUTDEVICE (winuser.h)

Article
03/06/2024

Définit des informations pour les périphériques d’entrée brute.

Syntaxe

typedef struct tagRAWINPUTDEVICE {
  USHORT usUsagePage;
  USHORT usUsage;
  DWORD  dwFlags;
  HWND   hwndTarget;
} RAWINPUTDEVICE, *PRAWINPUTDEVICE, *LPRAWINPUTDEVICE;

Membres

usUsagePage

Type : USHORT

Page Utilisation de la collection de niveau supérieur pour l’appareil d’entrée brute. Pour plus d’informations sur les valeurs possibles , consultez Clients HID pris en charge dans Windows .

usUsage

Type : USHORT

ID d’utilisation de la collection de niveau supérieur pour l’appareil d’entrée brute. Pour plus d’informations sur les valeurs possibles , consultez Clients HID pris en charge dans Windows .

dwFlags

Type : DWORD

Indicateur de mode qui spécifie comment interpréter les informations fournies par usUsagePage et usUsage. Il peut s’agir de zéro (valeur par défaut) ou de l’une des valeurs suivantes. Par défaut, le système d’exploitation envoie l’entrée brute des appareils avec la collection de niveau supérieur (TLC) spécifiée à l’application inscrite tant qu’elle a le focus de fenêtre.

Valeur	Signification
RIDEV_REMOVE 0x00000001	Si la valeur est définie, la collection de niveau supérieur est supprimée de la liste d’inclusion. Cela indique au système d’exploitation d’arrêter la lecture à partir d’un appareil qui correspond à la collection de niveau supérieur.
RIDEV_EXCLUDE 0x00000010	Si la valeur est définie, elle spécifie les collections de niveau supérieur à exclure lors de la lecture d’une page d’utilisation complète. Cet indicateur affecte uniquement un TLC dont la page d’utilisation est déjà spécifiée avec RIDEV_PAGEONLY.
RIDEV_PAGEONLY 0x00000020	Si la valeur est définie, elle spécifie tous les appareils dont la collection de niveau supérieur provient de l’usUsagePage spécifié. Notez que usUsage doit être égal à zéro. Pour exclure une collection de niveau supérieur particulière, utilisez RIDEV_EXCLUDE.
RIDEV_NOLEGACY 0x00000030	Si cette option est définie, cela empêche tous les appareils spécifiés par usUsagePage ou usUsage de générer des messages hérités. Il s’agit uniquement de la souris et du clavier. Consultez la section Notes.
RIDEV_INPUTSINK 0x00000100	Si elle est définie, cela permet à l’appelant de recevoir l’entrée même si l’appelant n’est pas au premier plan. Notez que hwndTarget doit être spécifié.
RIDEV_CAPTUREMOUSE 0x00000200	Si cette option est définie, le clic sur le bouton de la souris n’active pas l’autre fenêtre. RIDEV_CAPTUREMOUSE ne peut être spécifié que si RIDEV_NOLEGACY est spécifié pour un appareil de souris.
RIDEV_NOHOTKEYS 0x00000200	Si cette option est définie, les raccourcis clavier définis par l’application ne sont pas gérés. Toutefois, les raccourcis clavier système ; par exemple, ALT+TAB et CTRL+ALT+DEL, sont toujours gérés. Par défaut, tous les raccourcis clavier sont gérés. RIDEV_NOHOTKEYS peut être spécifié même si RIDEV_NOLEGACY n’est pas spécifié et si hwndTarget a la valeur NULL.
RIDEV_APPKEYS 0x00000400	Si elle est définie, les clés de commande d’application sont gérées. RIDEV_APPKEYS ne peuvent être spécifiés que si RIDEV_NOLEGACY est spécifié pour un clavier.
RIDEV_EXINPUTSINK 0x00001000	Si la valeur est définie, cela permet à l’appelant de recevoir une entrée en arrière-plan uniquement si l’application de premier plan ne les traite pas. En d’autres termes, si l’application de premier plan n’est pas inscrite pour l’entrée brute, l’application d’arrière-plan inscrite reçoit l’entrée. Windows XP : Cet indicateur n’est pas pris en charge tant que Windows Vista
RIDEV_DEVNOTIFY 0x00002000	Si cette option est définie, cela permet à l’appelant de recevoir WM_INPUT_DEVICE_CHANGE notifications pour l’arrivée et la suppression de l’appareil. Windows XP : Cet indicateur n’est pas pris en charge tant que Windows Vista

hwndTarget

Type : HWND

Handle de la fenêtre cible. Si la valeur EST NULL , elle suit le focus du clavier.

Remarques

Si RIDEV_NOLEGACY est défini pour une souris ou un clavier, le système ne génère aucun message hérité pour cet appareil pour l’application. Par exemple, si le TLC de la souris est défini avec RIDEV_NOLEGACY, WM_LBUTTONDOWN et les messages de souris hérités associés ne sont pas générés. De même, si le TLC du clavier est défini avec RIDEV_NOLEGACY, WM_KEYDOWN et les messages clavier hérités associés ne sont pas générés.

Si RIDEV_REMOVE est défini et que le membre hwndTarget n’est pas défini sur NULL, la fonction RegisterRawInputDevices échoue.

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]
En-tête	winuser.h (inclure Windows.h)