GetRawInputDeviceInfoA-Funktion (winuser.h)

Artikel
03/04/2024

Ruft Informationen zum Rohdateneingabegerä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 Rohdateneingabegerät. Dies stammt aus dem hDevice-Element von RAWINPUTHEADER oder aus GetRawInputDeviceList.

[in] uiCommand

Typ: UINT

Gibt an, welche Daten in pData zurückgegeben werden. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
RIDI_PREPARSEDDATA 0x20000005	pData ist ein PHIDP_PREPARSED_DATA Zeiger auf einen Puffer für die vorbereiteten Daten einer Sammlung der obersten Ebene.
RIDI_DEVICENAME 0x20000007	pData verweist auf eine Zeichenfolge, die den Namen der Geräteschnittstelle enthält. Wenn dieses Gerät im Modus für gemeinsamen Zugriff geöffnet ist, können Sie CreateFile mit diesem Namen aufrufen, um eine HID-Sammlung zu öffnen, und das zurückgegebene Handle zum Aufrufen von ReadFile zum Lesen von Eingabeberichten und WriteFile zum Senden von Ausgabeberichten verwenden. Weitere Informationen finden Sie unter Öffnen von HID-Sammlungen 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 die vorbereiteten Daten einer Sammlung der obersten Ebene.

RIDI_DEVICENAME
0x20000007

pData verweist auf eine Zeichenfolge, die den Namen der Geräteschnittstelle enthält.

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

Weitere Informationen finden Sie unter Öffnen von HID-Sammlungen 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 von uiCommand angegebenen Informationen enthält.

Wenn uiCommandRIDI_DEVICEINFO ist, legen Sie das cbSize-Element von RID_DEVICE_INFO auf fest sizeof(RID_DEVICE_INFO) , bevor Sie GetRawInputDeviceInfo aufrufen.

[in, out] pcbSize

Typ: PUINT

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

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 nicht groß genug für die Daten ist, gibt die Funktion -1 zurück. Wenn pDataNULL ist, gibt die Funktion den Wert 0 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.

Hinweise

Hinweis

Der winuser.h-Header definiert GetRawInputDeviceInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-rawinput-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)