Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 von GetRawInputDeviceList.
[in] uiCommand
Typ: UINT-
Gibt an, welche Daten in pData zurückgegeben werden. Dieser Parameter kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
pData ist ein PHIDP_PREPARSED_DATA Zeiger auf einen Puffer für die vordefinierten Daten einer Auflistung auf oberster Ebene. |
|
pData verweist auf eine Zeichenfolge, die den Geräteschnittstellennamen enthält.
Wenn dieses Gerät mit dem Modus für den freigegebenen Zugriff geöffnet wird, können Sie CreateFile mit diesem Namen aufrufen, um eine HID-Auflistung zu öffnen und das zurückgegebene Handle zum Aufrufen von ReadFile zum Lesen von Eingabeberichten und WriteFile zum Senden von Ausgabeberichten zu 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). |
|
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. Der Zeiger sollte an einer DWORD-Grenze (32-Bit) ausgerichtet werden.
Wenn uiCommandRIDI_DEVICEINFO ist, legen Sie das cbSize-Element von RID_DEVICE_INFO vor sizeof(RID_DEVICE_INFO) dem Aufrufen von GetRawInputDeviceInfo fest.
[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 für die Daten nicht groß genug ist, gibt die Funktion -1 zurück. Wenn pDataNULL ist, gibt die Funktion einen Wert von Null zurück. In beiden Fällen wird pcbSize auf die für den pData-Puffer erforderliche Mindestgröße festgelegt.
Rufen Sie GetLastError auf, um andere Fehler zu identifizieren.
Bemerkungen
Anmerkung
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 |
|---|---|
| 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
Referenz