RAWINPUTDEVICE-Struktur (winuser.h)

Artikel
08/28/2023

Definiert Informationen für die Geräte, die unformatierte Eingaben bereitstellen.

Syntax

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

Member

usUsagePage

Typ: USHORT

Seite "Verwendung der obersten Sammlung" für das Rohdateneingabegerät. Weitere Informationen zu möglichen Werten finden Sie unter In Windows unterstützte HID-Clients .

usUsage

Typ: USHORT

Verwendungs-ID der obersten Sammlung für das Rohdateneingabegerät. Weitere Informationen zu möglichen Werten finden Sie unter In Windows unterstützte HID-Clients .

dwFlags

Art: DWORD

Modusflag, das angibt, wie die von "usUsagePage " und " usUsage" bereitgestellten Informationen interpretiert werden. Es kann null (Standardwert) oder einer der folgenden Werte sein. Standardmäßig sendet das Betriebssystem unformatierte Eingaben von Geräten mit der angegebenen Obersten Sammlung (Top Level Collection , TLC) an die registrierte Anwendung, solange sie den Fensterfokus hat.

Wert	Bedeutung
RIDEV_REMOVE 0x00000001	Wenn festgelegt, wird die Auflistung der obersten Ebene aus der Aufnahmeliste 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 festgelegt, gibt dies die Sammlungen der obersten Ebene an, die beim Lesen einer vollständigen Verwendungsseite ausgeschlossen werden sollen. Dieses Flag wirkt sich nur auf einen TLC aus, dessen Nutzungsseite bereits mit RIDEV_PAGEONLY angegeben ist.
RIDEV_PAGEONLY 0x00000020	Wenn festgelegt, gibt dies alle Geräte an, deren Sammlung der obersten Ebene aus der angegebenen usUsagePage stammt. Beachten Sie, dass "usUsage " null sein muss. Um eine bestimmte Auflistung der obersten Ebene auszuschließen, verwenden Sie RIDEV_EXCLUDE.
RIDEV_NOLEGACY 0x00000030	Wenn festgelegt, wird verhindert, dass von usUsagePage oder usUsage angegebene Geräte Legacynachrichten generieren. Dies gilt nur für maus und tastatur. Siehe Hinweise.
RIDEV_INPUTSINK 0x00000100	Wenn festgelegt, 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 festgelegt, wird das andere Fenster durch Klicken auf die Maustaste nicht aktiviert. RIDEV_CAPTUREMOUSE können nur angegeben werden, wenn RIDEV_NOLEGACY für ein Mausgerät angegeben ist.
RIDEV_NOHOTKEYS 0x00000200	Wenn festgelegt, werden die anwendungsdefinierten Tastaturgeräte-Hotkeys nicht verarbeitet. Die System-Hotkeys werden jedoch verwendet. Beispielsweise werden ALT+TAB und STRG+ALT+ENTF weiterhin behandelt. Standardmäßig werden alle Tastatur-Hotkeys verarbeitet. RIDEV_NOHOTKEYS kann auch angegeben werden, wenn RIDEV_NOLEGACY nicht angegeben ist und hwndTargetNULL ist.
RIDEV_APPKEYS 0x00000400	Wenn festgelegt, werden die Anwendungsbefehlsschlüssel verarbeitet. RIDEV_APPKEYS können nur angegeben werden, wenn RIDEV_NOLEGACY für ein Tastaturgerät angegeben ist.
RIDEV_EXINPUTSINK 0x00001000	Wenn festgelegt, kann der Aufrufer eingaben im Hintergrund nur empfangen, wenn sie von der Vordergrundanwendung nicht verarbeitet werden. Anders ausgedrückt: Wenn die Vordergrundanwendung nicht für die Roheingabe registriert ist, empfängt die registrierte Hintergrundanwendung die Eingabe. Windows XP: Dieses Flag wird erst unter Windows Vista unterstützt.
RIDEV_DEVNOTIFY 0x00002000	Wenn festgelegt, kann der Anrufer WM_INPUT_DEVICE_CHANGE Benachrichtigungen für gerätezutreffen und geräteentfernung empfangen. Windows XP: Dieses Flag wird erst unter Windows Vista unterstützt.

hwndTarget

Typ: HWND

Ein Handle zum Zielfenster. Bei NULL folgt der Tastaturfokus.

Hinweise

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 der Maus-TLC beispielsweise mit RIDEV_NOLEGACY festgelegt ist, werden WM_LBUTTONDOWN und zugehörige Legacy-Mausnachrichten nicht generiert. Wenn die Tastatur-TLC mit RIDEV_NOLEGACY festgelegt ist, werden WM_KEYDOWN und zugehörige Ältere Tastaturmeldungen nicht generiert.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winuser.h (einschließlich Windows.h)