GetRawInputDeviceInfoA-Funktion (winuser.h)

Artikel
07/16/2024

Ruft Informationen zum unformatierten Eingabegerät ab.

Syntax

UINT GetRawInputDeviceInfoA(
  [in, optional]      HANDLE hDevice,
  [in]                UINT   uiCommand,
  [in, out, optional] LPVOID pData,
  [in, out]           PUINT  pcbSize
);

Parameter

[in, optional] hDevice

Typ: HANDLE

Ein Handle für das unformatierte Eingabegerät. Dies stammt aus dem hDevice Mitglied von RAWINPUTHEADER oder aus GetRawInputDeviceList.

[in] uiCommand

Typ: UINT-

Gibt an, welche Daten in pData-zurückgegeben werden sollen. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
RIDI_PREPARSEDDATA 0x20000005	pData- ist ein PHIDP_PREPARSED_DATA Zeiger auf einen Puffer für dieeiner Auflistung auf oberster Ebene.
RIDI_DEVICENAME 0x20000007	pData- verweist auf eine Zeichenfolge, die den namen der Geräteschnittstelleenthält. Wenn dieses Gerät mit dem Modus für den freigegebenen Zugriff geöffnet, können Sie CreateFile- mit diesem Namen aufrufen, um eine HID-Auflistung zu öffnen und zurückgegebene Handle zum Aufrufen ReadFile- zum Lesen von Eingabeberichten und WriteFile- zum Senden von Ausgabeberichten verwenden. Weitere Informationen finden Sie unter Öffnen von HID-Auflistungen und Behandeln von HID-Berichten. Nur für diesen uiCommand ist der Wert in pcbSize die Zeichenanzahl (nicht die Byteanzahl).
RIDI_DEVICEINFO 0x2000000b	pData- verweist auf eine RID_DEVICE_INFO Struktur.

Wert

Bedeutung

RIDI_PREPARSEDDATA
0x20000005

pData- ist ein PHIDP_PREPARSED_DATA Zeiger auf einen Puffer für dieeiner Auflistung auf oberster Ebene.

RIDI_DEVICENAME
0x20000007

pData- verweist auf eine Zeichenfolge, die den namen der Geräteschnittstelleenthält.

Wenn dieses Gerät mit dem Modus für den freigegebenen Zugriff geöffnet, können Sie CreateFile- mit diesem Namen aufrufen, um eine HID-Auflistung zu öffnen und zurückgegebene Handle zum Aufrufen ReadFile- zum Lesen von Eingabeberichten und WriteFile- zum Senden von Ausgabeberichten verwenden.

Weitere Informationen finden Sie unter Öffnen von HID-Auflistungen und Behandeln von HID-Berichten.

Nur für diesen uiCommand ist der Wert in pcbSize die Zeichenanzahl (nicht die Byteanzahl).

RIDI_DEVICEINFO
0x2000000b

pData- verweist auf eine RID_DEVICE_INFO Struktur.

[in, out, optional] pData

Typ: LPVOID-

Ein Zeiger auf einen Puffer, der die durch uiCommand-angegebenen Informationen enthält.

Wenn uiCommand-RIDI_DEVICEINFOist, legen Sie das cbSize Member von RID_DEVICE_INFO auf sizeof(RID_DEVICE_INFO) fest, bevor Sie GetRawInputDeviceInfoaufrufen.

[in, out] pcbSize

Typ: PUINT-

Die Größe der Daten in pData-in Byte.

Rückgabewert

Typ: UINT-

Bei erfolgreicher Ausführung gibt diese Funktion eine nicht negative Zahl zurück, die die Anzahl der in pData-kopierten Bytes angibt.

Wenn pData- für die Daten nicht groß genug ist, gibt die Funktion -1 zurück. Wenn pData-NULL-ist, gibt die Funktion einen Wert von Null zurück. In beiden Fällen wird pcbSize auf die mindestgröße festgelegt, die für den pData Puffer erforderlich ist.

Rufen Sie GetLastError- auf, um andere Fehler zu identifizieren.

Bemerkungen

Anmerkung

Der winuser.h-Header definiert GetRawInputDeviceInfo als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

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