RegisterRawInputDevices-Funktion (winuser.h)
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
Referenz