Freigeben über


GetRawInputDeviceInfoA-Funktion (winuser.h)

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.

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

Siehe auch

Konzeptionelle

RAWINPUTHEADER-

RID_DEVICE_INFO

raw Input

Referenz-

WM_INPUT

Top-Level Sammlungen

vorab analysierte Daten

PHIDP_PREPARSED_DATA

Öffnen von HID-Auflistungen

Behandeln von HID-Berichten