GetRegisteredRawInputDevices-Funktion (winuser.h)

Ruft die Informationen zu den rohen Eingabegeräten für die aktuelle Anwendung ab.

Syntax

UINT GetRegisteredRawInputDevices(
  [out, optional] PRAWINPUTDEVICE pRawInputDevices,
  [in, out]       PUINT           puiNumDevices,
  [in]            UINT            cbSize
);

Die Parameter

[out, optional] pRawInputDevices

Typ: PRAWINPUTDEVICE

Ein Array von RAWINPUTDEVICE-Strukturen für die Anwendung. Der Zeiger sollte an einer DWORD-Grenze (32-Bit) ausgerichtet werden.

[in, out] puiNumDevices

Typ: PUINT

Die Anzahl der RAWINPUTDEVICE-Strukturen in *pRawInputDevices.

[in] cbSize

Typ: UINT-

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

Rückgabewert

Typ: UINT-

Bei erfolgreicher Ausführung gibt die Funktion eine nicht negative Zahl zurück, die die Anzahl der in den Puffer geschriebenen RAWINPUTDEVICE-Strukturen darstellt.

Wenn der pRawInputDevices-Puffer zu klein oder NULL ist, legt die Funktion den letzten Fehler als ERROR_INSUFFICIENT_BUFFER, gibt -1 zurück und legt puiNumDevices auf die erforderliche Anzahl von Geräten fest. Wenn die Funktion aus einem anderen Grund fehlschlägt, wird -1 zurückgegeben. Rufen Sie GetLastError auf, um weitere Details zu erhalten.

Bemerkungen

Um unformatierte Eingaben von einem Gerät zu empfangen, muss eine Anwendung sie mithilfe von RegisterRawInputDevices registrieren.

Anforderungen

Siehe auch

Konzeptionelle

RAWINPUTDEVICE

raw Input

Referenz

RegisterRawInputDevices