Freigeben über


GetRawInputData-Funktion (winuser.h)

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
);

Die Parameter

[in] hRawInput

Typ: HRAWINPUT

Ein Handle zur RAWINPUT-Struktur . Dies stammt aus dem lParam in WM_INPUT.

[in] uiCommand

Typ: UINT-

Die Befehlskennzeichnung. Dieser Parameter kann einer der folgenden Werte sein:

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. Der Zeiger sollte an einer DWORD-Grenze (32-Bit) ausgerichtet werden.

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, lautet 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.

Bemerkungen

GetRawInputData ruft die rohe Eingabe jeweils eine RAWINPUT-Struktur ab. Im Gegensatz dazu ruft GetRawInputBuffer ein Array von RAWINPUT-Strukturen ab.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Überschrift winuser.h (enthalten Windows.h)
Bibliothek User32.lib
DLL User32.dll
API-Satz ext-ms-win-ntuser-rawinput-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzeptionelle

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

raw Input

Referenz