GetRawInputData-Funktion (winuser.h)

Artikel
03/04/2024

Ruft die rohe Eingabe vom angegebenen Gerät ab.

Syntax

UINT GetRawInputData(
  [in]            HRAWINPUT hRawInput,
  [in]            UINT      uiCommand,
  [out, optional] LPVOID    pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

Parameter

[in] hRawInput

Typ: HRAWINPUT

Ein Handle für die RAWINPUT-Struktur . Dies stammt aus dem lParam in WM_INPUT.

[in] uiCommand

Typ: UINT

Das Befehlsflag. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
RID_HEADER 0x10000005	Rufen Sie die Headerinformationen aus der RAWINPUT-Struktur ab.
RID_INPUT 0x10000003	Rufen Sie die Rohdaten aus der RAWINPUT-Struktur ab.

[out, optional] pData

Typ: LPVOID

Ein Zeiger auf die Daten, die aus der RAWINPUT-Struktur stammen. Dies hängt vom Wert von uiCommand ab. Wenn pDataNULL ist, wird die erforderliche Größe des Puffers in *pcbSize zurückgegeben.

[in, out] pcbSize

Typ: PUINT

Die Größe der Daten in pData in Bytes.

[in] cbSizeHeader

Typ: UINT

Die Größe der RAWINPUTHEADER-Struktur in Bytes.

Rückgabewert

Typ: UINT

Wenn pDataNULL ist und die Funktion erfolgreich ist, ist der Rückgabewert 0. Wenn pData nicht NULL ist und die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der in pData kopierten Bytes.

Wenn ein Fehler auftritt, lautet der Rückgabewert (UINT)-1.

Hinweise

GetRawInputData ruft die Roheingabe jeweils eine RAWINPUT-Struktur ab. Im Gegensatz dazu erhält GetRawInputBuffer ein Array von RAWINPUT-Strukturen .

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)