RAWINPUTDEVICE-Struktur (winuser.h)

Artikel
06/27/2024

Definiert Informationen für die unformatierten Eingabegeräte.

Syntax

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

Angehörige

usUsagePage

Typ: USHORT-

Sammlung der obersten Ebene Seite "Verwendung" für das rohe Eingabegerät. Weitere Informationen zu möglichen Werten finden Sie unter HID-Clients, die in Windows unterstützt werden.

usUsage

Typ: USHORT-

Sammlung der obersten Ebene Verwendungs-ID für das rohe Eingabegerät. Weitere Informationen zu möglichen Werten finden Sie unter HID-Clients, die in Windows unterstützt werden.

dwFlags

Typ: DWORD-

Moduskennzeichnung, die angibt, wie die von usUsagePage und usUsagebereitgestellten Informationen interpretiert werden. Er kann null (Standard) oder einer der folgenden Werte sein. Standardmäßig sendet das Betriebssystem unformatierte Eingaben von Geräten mit der angegebenen Sammlung auf oberster Ebene (TLC) an die registrierte Anwendung, solange sie den Fensterfokus hat.

Wert	Bedeutung
RIDEV_REMOVE 0x00000001	Wenn dieser Wert festgelegt ist, wird die Auflistung der obersten Ebene aus der Einschlussliste entfernt. Dadurch wird das Betriebssystem aufgefordert, das Lesen von einem Gerät zu beenden, das der Sammlung der obersten Ebene entspricht.
RIDEV_EXCLUDE 0x00000010	Wenn dieser Wert festgelegt ist, gibt dies die Auflistungen der obersten Ebene an, die beim Lesen einer vollständigen Verwendungsseite ausgeschlossen werden sollen. Dieses Kennzeichen wirkt sich nur auf einen TLC aus, dessen Verwendungsseite bereits mit RIDEV_PAGEONLYangegeben ist.
RIDEV_PAGEONLY 0x00000020	Bei Festlegung gibt dies alle Geräte an, deren Sammlung der obersten Ebene aus dem angegebenen usUsagePage-stammt. Beachten Sie, dass usUsage null sein muss. Um eine bestimmte Sammlung der obersten Ebene auszuschließen, verwenden Sie RIDEV_EXCLUDE.
RIDEV_NOLEGACY 0x00000030	Wenn festgelegt, verhindert dies, dass alle geräte, die durch usUsagePage oder usUsage angegeben werden,Legacynachrichtengenerieren. Dies gilt nur für Maus und Tastatur. Siehe Anmerkungen.
RIDEV_INPUTSINK 0x00000100	Wenn dieser Wert festgelegt ist, kann der Aufrufer die Eingabe auch dann empfangen, wenn sich der Aufrufer nicht im Vordergrund befindet. Beachten Sie, dass hwndTarget- angegeben werden muss.
RIDEV_CAPTUREMOUSE 0x00000200	Wenn dieser Wert festgelegt ist, wird durch Klicken auf die Maustaste das andere Fenster nicht aktiviert. RIDEV_CAPTUREMOUSE kann nur angegeben werden, wenn RIDEV_NOLEGACY für ein Mausgerät angegeben ist.
RIDEV_NOHOTKEYS 0x00000200	Bei Festlegung werden die anwendungsdefinierten Tastaturgeräte-Hotkeys nicht behandelt. Die System-Hotkeys jedoch; Beispielsweise werden ALT+TAB und STRG+ALT+ENTF weiterhin behandelt. Standardmäßig werden alle Tastatur-Hotkeys behandelt. RIDEV_NOHOTKEYS können auch angegeben werden, wenn RIDEV_NOLEGACY nicht angegeben ist und hwndTargetNULL-ist.
RIDEV_APPKEYS 0x00000400	Bei Festlegung werden die Anwendungsbefehltasten behandelt. RIDEV_APPKEYS kann nur angegeben werden, wenn RIDEV_NOLEGACY für ein Tastaturgerät angegeben ist.
RIDEV_EXINPUTSINK 0x00001000	Wenn dieser Wert festgelegt ist, kann der Aufrufer nur dann Eingaben im Hintergrund empfangen, wenn die Vordergrundanwendung sie nicht verarbeitet. Anders ausgedrückt: Wenn die Vordergrundanwendung nicht für unformatierte Eingaben registriert ist, erhält die registrierte Hintergrundanwendung die Eingabe. Windows XP: Dieses Flag wird erst unterstützt, wenn Windows Vista
RIDEV_DEVNOTIFY 0x00002000	Wenn diese Einstellung festgelegt ist, kann der Anrufer WM_INPUT_DEVICE_CHANGE Benachrichtigungen zur Geräteannahme und Zum Entfernen des Geräts empfangen. Windows XP: Dieses Flag wird erst unterstützt, wenn Windows Vista

hwndTarget

Typ: HWND-

Ein Handle für das Zielfenster. Wenn NULL-, folgen unformatierte Eingabeereignisse dem Tastaturfokus, um sicherzustellen, dass nur das fokussierte Anwendungsfenster die Ereignisse empfängt.

Bemerkungen

Wenn RIDEV_NOLEGACY für eine Maus oder Tastatur festgelegt ist, generiert das System keine Legacymeldung für dieses Gerät für die Anwendung. Wenn z. B. der Maus-TLC mit RIDEV_NOLEGACY, WM_LBUTTONDOWN und zugehörigen älteren Mausnachrichten festgelegt ist, nicht generiert werden. Ebenso werden, wenn die Tastatur-TLC mit RIDEV_NOLEGACY, WM_KEYDOWN und zugehörigen älteren Tastaturnachrichten nicht generiert werden.

Wenn RIDEV_REMOVE festgelegt ist und das hwndTarget Member nicht auf NULL-festgelegt ist, schlägt RegisterRawInputDevices Funktion fehl.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	winuser.h (enthalten Windows.h)