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

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)

Siehe auch

Konzept

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

Unformatierte Eingabe

Referenz