GetRawInputDeviceInfoW-Funktion (winuser.h)
Ruft Informationen zum Rohdateneingabegerät ab.
Syntax
UINT GetRawInputDeviceInfoW(
[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 |
---|---|
|
pData ist ein PHIDP_PREPARSED_DATA Zeiger auf einen Puffer für die vorbereiteten Daten einer Sammlung der obersten Ebene. |
|
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). |
|
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) |
Siehe auch
Konzept
Referenz
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für