RAWINPUTDEVICE, structure (winuser.h)

Article
06/27/2024

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

Syntaxe

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

Membres

usUsagePage

Type : USHORT

collection de niveau supérieur page Utilisation pour l’appareil d’entrée brute. Consultez clients HID pris en charge dans Windows pour plus d’informations sur les valeurs possibles.

usUsage

Type : USHORT

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

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 une entrée brute à partir d’appareils avec le de collecte de niveau supérieur spécifié (TLC) à l’application inscrite tant qu’elle a le focus sur la fenêtre.

Valeur	Signification
RIDEV_REMOVE 0x00000001	Si elle est définie, cela supprime la collection de niveau supérieur 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 elle est définie, cela 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 elle est définie, cela 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 particulier, utilisez RIDEV_EXCLUDE.
RIDEV_NOLEGACY 0x00000030	S’il est défini, cela empêche les appareils spécifiés par usUsagePage ou usUsage de générer messages hérités. Il s’agit uniquement de la souris et du clavier. Voir les remarques.
RIDEV_INPUTSINK 0x00000100	Si cette option est définie, l’appelant peut recevoir l’entrée même lorsque l’appelant n’est pas au premier plan. Notez que hwndTarget doivent être spécifiés.
RIDEV_CAPTUREMOUSE 0x00000200	Si cette option est définie, le clic du 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 elle est définie, les touches d’accès à chaud de l’appareil clavier définies par l’application ne sont pas gérées. Toutefois, les touches d’accès système ; Par exemple, Alt+Tab et Ctrl+Alt+Del sont toujours gérés. Par défaut, toutes les touches d’accès clavier sont gérées. RIDEV_NOHOTKEYS peut être spécifié même si RIDEV_NOLEGACY n’est pas spécifié et hwndTarget est NULL.
RIDEV_APPKEYS 0x00000400	Si elle est définie, les clés de commande d’application sont gérées. RIDEV_APPKEYS ne peut être spécifié que si RIDEV_NOLEGACY est spécifié pour un périphérique clavier.
RIDEV_EXINPUTSINK 0x00001000	Si elle est définie, l’appelant peut recevoir une entrée en arrière-plan uniquement si l’application de premier plan ne le traite pas. En d’autres termes, si l’application de premier plan n’est pas inscrite pour l’entrée brute, l’application en arrière-plan inscrite reçoit l’entrée. Windows XP : cet indicateur n’est pas pris en charge tant que Windows Vista n’est pas pris en charge
RIDEV_DEVNOTIFY 0x00002000	Si cette option est définie, l’appelant peut recevoir des notifications WM_INPUT_DEVICE_CHANGE pour l’arrivée de l’appareil et la suppression de l’appareil. Windows XP : cet indicateur n’est pas pris en charge tant que Windows Vista n’est pas pris en charge

hwndTarget

Type : HWND

Handle vers la fenêtre cible. Si NULL, les événements d’entrée brute suivent le focus clavier pour s’assurer que seule la fenêtre d’application prioritaire reçoit les événements.

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 messages de souris hérités associés ne sont pas générés. De même, si le clavier TLC est défini avec RIDEV_NOLEGACY, WM_KEYDOWN et 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, RegisterRawInputDevices fonction échoue.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	winuser.h (include Windows.h)