RegisterRawInputDevices-Funktion (winuser.h)

Registriert die Geräte, die die rohen Eingabedaten bereitstellen.

Syntax

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

Die Parameter

[in] pRawInputDevices

Typ: PCRAWINPUTDEVICE

Ein Array von RAWINPUTDEVICE-Strukturen , die die Geräte darstellen, die die Roheingabe bereitstellen. Der Zeiger sollte an einer DWORD-Grenze (32-Bit) ausgerichtet werden.

[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.

Bemerkungen

Um WM_INPUT Nachrichten zu empfangen, muss eine Anwendung zunächst die rohen Eingabegerä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 durch die Felder "usUsagePage" und "usUsagePage" der RAWINPUTDEVICE-Struktur angegeben wird. Standardmäßig empfängt eine Anwendung keine WM_INPUT_DEVICE_CHANGE Benachrichtigungen für die Ankunft und Entfernung des rohen Eingabegeräts.

Wenn eine RAWINPUTDEVICE-Struktur den RIDEV_REMOVE Flag festgelegt hat und der hwndTarget-Parameter nicht auf NULL festgelegt ist, schlägt die Parameterüberprüfung fehl.

Es kann nur ein Fenster pro Unformatierungsgeräteklasse registriert werden, um rohe Eingaben in einem Prozess zu empfangen (das Fenster, das im letzten Aufruf von RegisterRawInputDevices übergeben wurde). Aus diesem Grund sollte "RegisterRawInputDevices" nicht aus einer Bibliothek verwendet werden, da dies zu einer Störung der Roheingabeverarbeitungslogik führen kann, die bereits in Anwendungen vorhanden ist, die sie laden.

Anforderungen

Siehe auch

Konzeptionelle

RAWINPUTDEVICE

raw Input

Referenz

WM_INPUT