RegisterRawInputDevices-Funktion (winuser.h)

  • Artikel

Registriert die Geräte, die unformatierte Eingabedaten bereitstellen.

Syntax

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

Parameter

[in] pRawInputDevices

Typ: PCRAWINPUTDEVICE

Ein Array von RAWINPUTDEVICE-Strukturen , die die Geräte darstellen, die die Roheingabe bereitstellen.

[in] uiNumDevices

Typ: UINT

Die Anzahl der RAWINPUTDEVICE-Strukturen , auf die von pRawInputDevices verwiesen wird.

[in] cbSize

Typ: UINT

Die Größe einer RAWINPUTDEVICE-Struktur in Bytes.

Rückgabewert

Typ: BOOL

TRUE , wenn die Funktion erfolgreich ist; andernfalls FALSE. Wenn die Funktion fehlschlägt, rufen Sie GetLastError auf, um weitere Informationen zu erhalten.

Hinweise

Um WM_INPUT Nachrichten zu empfangen, muss eine Anwendung zuerst die Rohdateneingabegeräte mithilfe von RegisterRawInputDevices registrieren. Standardmäßig empfängt eine Anwendung keine unformatierte Eingabe.

Um WM_INPUT_DEVICE_CHANGE Nachrichten zu empfangen, muss eine Anwendung das RIDEV_DEVNOTIFY-Flag für jede Geräteklasse angeben, die in den Feldern usUsagePage und usUsage der RAWINPUTDEVICE-Struktur angegeben wird. Standardmäßig empfängt eine Anwendung keine WM_INPUT_DEVICE_CHANGE Benachrichtigungen für das Ein- und Entfernen eines Rohdateneingabegeräts.

Wenn für eine RAWINPUTDEVICE-Struktur das flag RIDEV_REMOVE festgelegt ist und der hwndTarget-Parameter nicht auf NULL festgelegt ist, schlägt die Parameterüberprüfung fehl.

Es kann nur ein Fenster pro Raw-Eingabegeräteklasse registriert werden, um rohe Eingaben innerhalb eines Prozesses zu empfangen (das Fenster wurde beim letzten Aufruf von RegisterRawInputDevices übergeben). Aus diesem Grund sollten RegisterRawInputDevices nicht aus einer Bibliothek verwendet werden, da dies die Rohdatenverarbeitungslogik beeinträchtigen kann, die bereits in Anwendungen vorhanden ist, die sie laden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-rawinput-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzept

RAWINPUTDEVICE

Unformatierte Eingabe

Referenz

WM_INPUT